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SENTRAN7:  The  Sensitivity  Analysis  Package 
for  LOWTRAN7  and  MODTRAN 


1  INTRODUCTION 

I. 1  Background  and  Purpose  of  Study 

The  Optical  Environment  Division  of  the  Geophysics  Directorate  of  the  Phillips 
Laboratory  (PL/GPO)  has  developed  a  number  of  computer  codes  to  evaluate  at¬ 
mospheric  transmittance  and  background  radiance  for  a  given  atmospheric  path  and 
frequency  region.  The  LOWTRAN71  model,  and  its  predecessor  LOWTRAN62, 
have  been  recognized  by  the  DoD  community  as  the  standard  for  calculating  at¬ 
mospheric  transmission  and  radiance  at  low  spectral  resolution.  The  LOWTRAN 
series  has  been  widely  used  for  studies  of  atmospheric  propagation  of  electromag¬ 
netic  waves  in  the  visible  and  infrared. 

\n  important  key  to  a  successful  utilization  of  LOWTRAN  is  the  accuracy  of 
the  input  atmospheric  data.  In  order  for  the  LOWTRAN  output  to  be  useful,  the 

1  Kneizys,  F.X.,  Shettle,  E.P.,  Abreu,  L.W.,  Chetwynd,  J.H.,  Anderson,  G.P.,  Gallery,  W.O.,  Selby, 

J. E.A,  and  Clough,  S.A.  (1988)  Users  Guide  to  LOWTRAN7,  Air  Force  Geophysics  Laboratory, 
Hanscom  AFB,  MA,  AFGL-TR-88-0177,  ADA206773. 

2  Kneizys,  F.X.,  Shettle,  E.P.,  Gallery,  W.O.,  Chetwynd,  J.H.,  Abreu,  L.W.,  Selby,  J.E.A. , 
Clough,  S.A.,  and  Fenn,  R.W.  (1983)  Atmospheric  Transmittance/Radiance:  Computer  Code 
LOWTRAN  6,  Air  Force  Geophysics  Laboratory,  Hanscom  AFB,  MA,  AFGL-TR-83-0187, 
ADA  137796. 
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corresponding  input  must  be  accurate.  However,  some  atmospheric  variables  are 
inherently  difficult  to  obtain  or  to  predict  accurately  due  to  their  natural  variation. 
Unavoidable  uncertainties  occur  in  these  variables  regardless  of  how  they  are  ob¬ 
tained.  The  effects  of  these  uncertainties  on  LOWTRAN  computations  must  be 
critically  evaluated  if  the  LOWTRAN  results  are  to  be  meaningful  and  reliable. 

In  response  to  these  needs,  a  systematic  sensitivity  analysis  plan  was  developed 
for  LOWTRAN6.  The  plan  was  to  quantitatively,  as  well  as  qualitatively,  evaluate 
variations  in  transmittances  and  radiances  from  LOWTRAN6  against  perturbations 
in  input  atmospheric  conditions.  The  plan  eventually  evolved  into  a  computer  soft¬ 
ware  package,  called  SENTRAN3  (SENsitivity  analysis  plan  for  lowTRAN).  The 
capability  of  SENTRAN  greatly  exceeded  the  originally  conceived  specifications 
for  the  plan,  in  that  it’s  usefulness  was  not  limited  to  sensitivity  analyses.  It  be¬ 
came  apparent  that  SENTRAN  could  revolutionize  the  way  in  which  LOWTRAN6 
was  used  and  the  scope  of  analyses  that  could  be  performed. 

Since  the  development  of  the  SENTRAN  code,  the  Geophysics  Directorate 
released  LOWTRAN7  which  contains  revised  formats  for  the  input  card  images 
and  additional  parameters  to  characterize  the  atmospheric  path.  Therefore,  the  main 
purpose  of  this  effort  has  been  to  make  SENTRAN  compatible  with  LOWTRAN7. 
The  new  computer  code  is  called  SENTRAN7.  At  the  same  time,  the  scope  of 
SENTRAN7  was  broadened  to  include  sensitivity  studies  for  MODTRAN.4  The 
decision  to  include  MODTRAN  is  reasonable  because  the  format  of  the  input  card 
images  for  MODTRAN  is  essentially  the  same  as  LOWTRAN7.  With  the  addition 
of  MODTRAN,  users  can  now  perform  sensitivity  studies  for  spectral  resolutions 
down  to  2  cm-1,  instead  of  20  cm-1  as  with  LOWTRAN7. 

1.2  Organization  of  the  Report 

This  report  consists  of  seven  chapters  and  four  appendices.  The  report  is  com¬ 
plete  in  itself,  although  much  of  the  material  is  taken  from  the  original  SENTRAN 
final  report.3  Chapter  2  describes  the  work  performed  in  this  effort,  including  the 
upgrade  to  LOWTRAN7  and  new  features  which  have  been  added.  Chapter  3 
describes  the  steps  required  to  install  and  run  SENTRAN7  on  a  user’s  computer 
system.  Chapter  4  contains  a  Users  Guide  which  gives  a  general  overview  of  SEN- 
TRAN7,  along  with  a  detailed  description  of  how  to  use  SENTRAN7.  Chapter  5  is 
a  Tutorial  which  leads  the  user  through  a  series  of  brief  exercises  with  SENTRAN7. 
Chapter  6  describes  initial  efforts  to  develop  an  alternate  sensitivity  package  for 

3  Tomiyama,  K.  and  Hogan,  M.  (1988)  Sensitivity  Evaluation  Plan  for  LOWTRAN,  Department  of 
Electrical  Engineering,  The  Pennsylvania  State  University. 

4  Berk,  A.,  Bernstein,  L.S.,  and  Robertson,  D.C.  (1989)  MODTRAN:  A  Moderate  Resolution  Model 
for  LOWTRAN7 ,  Air  Force  Geophysics  Laboratory,  Hanscom  AFB,  MA,  AFGL-TR-89-0122, 
ADA214337. 
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FASCOD3.5  Conclusions  and  suggestions  for  further  research  are  summarized  in 
Chapter  7.  Appendix  A  describes  the  input  and  output  files  used  by  SENTRAN7. 
Appendix  B  contains  the  source  code  changes  made  to  LOWTRAN7  and  MOD- 
TRAN.  Appendix  C  is  a  Quick  Reference  Guide  which  contains  brief  summaries  of 
SENTRAN7  commands  and  files  that  make  up  the  SENTRAN7  package.  Finally, 
Appendix  D  contains  a  flow  chart  of  SENTRAN7’s  Graph  and  Analyze  Module’s 
program  flow. 

Familiarity  with  LOWTRAN7  and  MODTRAN  is  presumed  throughout  this 
report.  Therefore,  the  LOWTRAN7  Users  Guide1  and  the  MODTRAN  Users 
Guide4  should  be  used  as  companion  guides  for  learning  the  SENTRAN7  system. 


5  Clough,  S.A.,  Kneizys,  F.X.,  Anderson,  G.P.,  Shettle,  E.P.,  Chetwynd,  J.H.,  Abreu,  L.W.,  Hall, 
L.A.,  and  Worsham,  R.D.  (1989)  FASCOD3:  Spectral  Simulation  in  IRS' 88:  Current  Problems 
in  Atmospheric  Radiation,  J.  Lenoble  and  J.F.  GeLeyn  (Eds.),  A.  Deepak  Publishing,  Hampton, 
VA,  pp.  372-375. 
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2  WORK  PERFORMED  ON  SENTRAN7 

This  chapter  describes  specific  tasks  performed  on  SENTRAN7  during  the  cur¬ 
rent  effort.  The  tasks  are  subdivided  into  three  categories:  coding  changes  required 
to  upgrade  the  original  SENTRAN  code,  improvements  made  to  the  original  SEN- 
TRAN  code,  and  new  features  included  in  SENTRAN7.  The  decision  to  include 
various  new  features  in  SENTRAN7  was  based  on  feedback  from  prospective  users, 
as  well  as  time  constraints. 

2.1  Notations  Used  in  This  Report 

Throughout  this  report,  the  following  notations  are  used: 

•  Commands  that  must  be  entered  by  the  user  are  set  off  by  single  quotation 
marks  and  appear  in  boldface  in  lower  case  print,  ( e.g .,  ‘help’).  (The  4’ 
delimiters  are  not  entered  as  part  of  the  command.)  Note  that  SENTRAN7 
is  case  insensitive  and,  therefore,  users  can  enter  all  commands  in  lower  or 
upper  case. 

•  File  names  used  by  SENTRAN  7  appear  in  italics  (e.g.,  TAP E7. OUT).  The 
file  names  are  written  in  either  upper  or  lower  case,  exactly  as  they  would 
appear  on  a  UND(  computer  system,  which  is  case  sensitive.  Note  that  if 
the  user  is  operating  SENTRAN7  on  a  UNIX  computer  system,  all  input 
and  output  files  created  by  SENTRAN7  are  in  upper  case.  This  is  because 
SENTRAN7  internally  converts  ail  commands  entered  by  the  user  to  upper 
case  and,  therefore,  accesses  all  file  names  within  these  commands  as  upper 
case  file  names.  UNIX  system  users  only  need  to  be  concerned  with  the 
file  name  case  when  accessing  these  files  from  outside  of  SENTRAN7.  If 
running  SENTRAN7  on  a  VAX/VMS  computer  system,  all  file  names  are 
in  upper  case. 

•  The  word,  RETURN,  implies  hitting  the  return  (or  enter)  key  on  the  user’s 
keyboard. 

2.2  Brief  Overview  of  SENTRAN7 

SENTRAN7  is  structured  into  a  number  of  subprograms  called  modules.  Each 
module  performs  a  specific  task  to  aid  users  in  their  sensitivity  studies.  These 
modules  include: 

•  A  Load/Save  Module  for  loading  and  saving  SENTRAN7  methodology 
files 

•  An  Edit  Module  for  specifying  the  values  of  parameters  on  LOWTRAN7 
card  images,  along  with  directions  for  their  perturbation 
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•  A  Compile  Module  for  creating  LOWTRAN7  input  files 

•  A  Select  Module  for  selecting  which  transmission  model  to  execute 

•  A  Run  Module  for  executing  the  selected  transmission  model 

•  A  Graph  and  Analyze  Module  (G  &  A)  for  extracting  output  data  for  data 
analysis  and  plotting 

•  A  Help  Module  for  providing  on-line  help  for  SENTRAN7  users 

2.3  Upgrade  of  the  Original  SENTRAN  Code 

The  Edit  and  Compile  Modules  in  the  original  SENTRAN  code  were  updated 
to  mimic  the  flow  through  LOWTRAN7.  As  with  the  original  code,  some  of 
LOWTRAN7’s  input  parameters  cannot  be  perturbed  because  their  perturbation 
creates  different  flows  through  the  input  card  images.  Table  1  shows  the  input 
parameters  in  LOWTRAN7  that  are  restricted  to  one  value  (i.e.,  no  perturbation 
directives  allowed)  in  SENTRAN7. 

Data  for  some  LOWTRAN7  input  cards  cannot  be  entered  easily  within  SEN- 
TRAN7  because  it  involves  excessive  amounts  of  terminal  input.  For  these  card 
series,  SENTRAN7  reads  the  input  data  from  external  files  with  default  extensions. 
These  files  must  be  created  off-line  by  the  user.  During  an  editing  session,  SEN- 
TRAN7  prompts  users  for  the  names  of  these  files.  For  reference.  Table  2  lists  the 
LOWTRAN  card  series  that  are  read  as  external  files  and  their  default  extensions. 
Appendix  A  gives  a  detailed  description  of  each  of  these  files.  The  format  of  the 
external  files  should  match  the  format  of  the  LOWTRAN7  input  cards  that  they 
represent. 

After  specifying  an  external  data  file,  SENTRAN7  allows  users  to  perturb  input 
variables  in  the  file  by  means  of  a  percent  perturbation.  For  the  Card  2C  series, 
the  percent  perturbation  is  only  applied  to  the  layers  of  the  minor  and  trace  gas 
profile  where  the  units  control  variable,  JCHAR,  is  not  set  to  a  model  atmosphere 
between  1  and  6.  For  the  Card  2D  series,  the  percent  perturbation  is  applied  to  all 
(47)  wavelengths  of  aerosol  attenuation  data  for  a  particular  altitude  region.  It  is 
noted  that  the  Card  3B  series  for  aerosol  phase  functions  cannot  be  perturbed  in  the 
current  version  of  SENTRAN7.  (Note:  the  notation  in  this  paragraph  demonstrates 
the  need  to  be  familiar  with  LOWTRAN7  and  MODTRAN.) 

2.4  Improvements  to  the  Original  SENTRAN  Code 

The  upgrade  of  the  original  SENTRAN  code  to  LOWTRAN7  constituted  a  large 
portion  of  the  current  effort.  During  the  upgrade  however,  a  number  of  existing 
features  in  the  original  code  were  improved.  These  additional  improvements  are 
described  below. 
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Table  1 .  L0WTRAN7  Input  Parameters  That  Cannot  Be  Perturbed  in  SENTRAN7 


INPUT 

PARAMETER 

CARD 

COMMENT 

MODEL 

1 

Restricted  when  MODEL=0  or  7 

ITYPE 

1 

IEMSCT 

1 

IMULT 

1 

IM 

1 

Internally  set  by  SENTRAN7 

NOPRT 

1 

IHAZE 

2 

Restricted  when  IHAZE=7 

ICLD 

2 

IVSA 

2 

IPARM 

3A1 

IPH 

3A1 

ISOURC 

3A1 

VI,  V2,  DV 

4 

Table  2.  LOWTRAN7  Card  Series  That  are  Read  as  External  Data  Files 


CARD 

SERIES 

FILE 

EXTENSION 

CONTENTS 

2C 

PRO 

User  defined  minor  and  trace  profiles.  Repeat  2C1 

2C1 

through  2C3  to  describe  complete  vertical  profile 

2C2 

2C3 

2D 

AER 

Aerosol  or  cloud  scaling  factors  versus  wavelength. 

2D1 

Repeat  2D2  as  necessary  for  47  wavelengths 

2D2 

3B1 

PHS 

Aerosol  phase  function.  Repeat  3B2  as  necessary 

3B2 

to  describe  entire  phase  function 
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2.4.1  Smarter  Editing  Restrictions 

In  a  few  instances,  the  original  SENTRAN  code  allowed  users  to  specify  LOW- 
TRAN6  input  parameters  that  did  not  pertain  to  the  particular  problem  being  simu¬ 
lated.  For  example,  users  were  always  able  to  set  the  wind  speed  on  Card  2,  even 
though  it  was  only  used  with  the  Navy  maritime  aerosol  model  (IHAZE=3).  Early 
in  the  upgrade  process,  it  became  clear  that  this  shortfall  could  lead  to  confusion 
among  users  of  LOWTRAN7. 

Given  the  complicated  nature  of  the  LOWTRAN7  input  card  images,  SEN- 
TRAN7  contains  “smarter”  editing  restrictions  that  allow  users  to  specify  only  the 
required  LOWTRAN7  input  parameters.  That  is,  some  LOWTRAN7  input  cards 
or  individual  variables  are  only  required  if  other  variables  are  specified.  For  exam¬ 
ple,  LOWTRAN7’s  multiple  scattering  option  can  only  be  invoked  if  radiances  are 
being  calculated.  The  SENTRAN7  editor  has  been  designed  to  take  these  kinds  of 
restrictions  into  account,  thereby  trying  to  simplify  the  input  process  (and  frequent 
referrals  to  the  LOWTRAN7  technical  manual)  for  the  user.  At  the  same  time, 
the  SENTRAN7  editor  internally  “hardwires”  the  values  of  some  input  parameters 
(or  resets  them  to  zero),  based  on  previous  user  inputs.  Users  will  encounter  this 
enhanced  feature  of  SENTRAN7  primarily  while  editing  Cards  1,  2,  3,  and  3A2. 

2.4.2  Improved  Error  Checking  on  User  Inputs 

During  an  editing  session,  the  original  SENTRAN  code  performed  error  check¬ 
ing  on  a  LOWTRAN6  parameter  by  comparing  the  user  input  with  numerical 
limits  internally  set  within  the  code.  This  is  an  extremely  useful  feature;  how¬ 
ever,  some  of  die  limits  did  not  adequately  represent  the  LOWTRAN6  parameters. 
Consequently,  a  subsequent  LOWTRAN6  run  could  automatically  reset  some  input 
parameters  and  produce  confusion.  Therefore,  considerable  attention  was  devoted 
to  providing  error  checking  on  user  inputs.  Improved  limits  on  LOWTRAN7  in¬ 
puts  are  based  on  those  from  the  Users  Guide  for  LOWTRAN71,  common  sense, 
and  personal  experience. 

The  user  is  urged  to  note,  however,  that  the  current  version  of  SENTRAN7 
does  not  check  input  data  from  external  files  for  physical  consistency.  Although 
this  feature  would  be  extremely  valuable  for  user-defined  atmospheres  on  Card  2C, 
a  complete  and  thorough  treatment  of  the  problem  was  beyond  the  current  effort. 
Therefore,  users  must  recognize  that  certain  perturbations  of  pressure,  temperature, 
and/or  water  vapor  can  lead  to  physical  inconsistencies,  such  as  relative  humidities 
exceeding  100%.  (Note:  Both  LOWTRAN  &  MODTRAN  reset  relative  humidities 
greater  than  100%  to  100%  during  calculations.)  Also,  physical  inconsistencies  are 
possible  in  the  Card  2D  series  when  users  perturb  aerosol  extinction,  absorption, 
and  asymmetry  parameters.  Future  versions  of  SENTRAN7  will  hopefully  include 
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an  error  checking  feature  that  warns  users  about  physical  inconsistencies  created 
by  their  perturbation  studies. 

2.4.3  Refined  Identification  of  Major  Molecular  Absorbers 

When  compiling  an  input  file,  the  original  SENTRAN  code  provided  informa¬ 
tion  about  active  molecular  absorbers  in  the  spectral  region  of  the  LOWTRAN6 
calculation.  However,  this  information  was  spectrally  incomplete  and  limited  to 
five  of  the  twelve  molecules  for  which  absorption  data  are  internally  stored  in 
LOWTRAN7. 

For  SENTRAN7,  the  regions  of  molecular  absorption  were  refined  using  line 
parameters  in  MODTRAN’s  BMTAPE.DAT  data  file  because  this  file  provided  a 
“quick  access”  to  the  molecular  absorption  data  internally  stored  in  LOWTRAN7. 
(The  BMTAPE.DAT  data  file  is  an  input  file  that  accompanies  the  standard  MOD- 
TRAN  program.)  Absorption  data  from  BMTAPE.DAT  were  then  condensed  in  an 
external  data  file  called  MAJABS.DAT.  (This  file  is  included  in  the  SENTRAN7 
package  and  must  reside  in  the  SENTRAN7  executable  directory.) 

For  reference,  Table  3  lists  the  twelve  molecules  for  which  absorption  data  are 
available  in  MAJABS.DAT.  Figure  1  shows  the  contents  of  MAJABS.DAT.  After 
one  line  of  header  material,  the  file  contains  three  columns  of  data  that  identify  the 
molecule,  and  the  beginning  and  end  integer  wavenumber  of  its  absorption  band. 
Gaps  between  absorption  bands  of  less  than  25  cm'1  have  been  ignored  in  order 
to  show  general  regions  of  molecular  absorption,  as  well  as  reduce  the  size  of 
MAJABS.DAT. 

Regions  of  absorption  are  always  displayed  on  the  terminal  during  compila¬ 
tion,  and  the  output  can  be  optionally  directed  to  a  file  called  SEN. ERR  (see  Sec¬ 
tion  4.2.4.3).  For  large  spectral  regions,  the  process  of  displaying  active  molecular 
absorbers  often  exceeds  the  number  of  available  lines  on  the  screen.  To  compensate 
for  this,  the  SENTRAN7  compiler  contains  a  scrolling  feature  that  allows  users 
to  view  a  portion  of  the  output  in  a  window  on  the  terminal.  Subsequent  output 
is  then  displayed  by  hitting  RETURN.  Figure  2  shows  how  the  major  molecular 
absorbers  are  displayed  by  the  SENTRAN7  compiler. 

2.4.4  Additional  Plotting  Capabilities 

Additional  plotting  capabilities  have  been  added  to  SENTRAN7.  Specifically, 
data  can  now  be  plotted  from  the  tapeS  output  files  produced  by  LOWTRAN7. 
All  of  the  currently  available  plots  are  listed  in  Table  4.  Along  with  additional 
transmittance  plots,  SENTRAN7  is  capable  of  plotting  differential  transmittance, 
black  body  functions,  plus  upward  and  downward  fluxes.  These  plotting  options 
will  automatically  be  displayed  to  the  user  in  the  Graph  and  Analyze  Module  of 
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Table  3.  List  of  Molecules  For  Which  Regions  of  Absorption  Are  Displayed  by  the 
SENTRAN7  Compiler.  The  molecules  listed  here  represent  all  of  those  molecules 
internally  stored  in  LOWTRAN7  and  MODTRAN 


NUMBER 

MOLECULAR 

SPECIES 

1 

Water  vapor  (FLO) 

2 

Carbon  dioxide  (CO2) 

3 

Ozone  (O3) 

4 

Nitrous  oxide  (N2O) 

5 

Carbon  monoxide  (CO) 

6 

Methane  (CH,{) 

7 

Oxygen  (02) 

8 

Nitric  oxide  (NO) 

9 

Sulphur  dioxide  (SO2) 

10 

Nitrogen  dioxide  (NO2) 

11 

Ammonia  (NH3) 

12 

Nitric  acid  (HNO3) 

SENTRAN7  when  choosing  a  plot  type,  if  the  values  of  IEMSCT,  IMULT,  and 
NOPRT  on  Card  1  are  set  appropriately  within  the  Edit  Module  of  SENTRAN7. 
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8  9 

16  28 

32  37  47  50  54  68  59  62 

1 

0 

9508 

1 

9S34 

9625 

1 

9652 

11528 

1 

11577 

12938 

1 

13274 

14733 

1 

14776 

14776 

1 

14908 

16964 

1 

16466 

17880 

2 

1 

9999 

3 

0 

190 

3 

561 

1270 

3 

1657 

2269 

3 

2736 

2806 

3 

2963 

3066 

3 

13000 

24200 

3 

27370 

50000 

4 

1 

70 

4 

523 

752 

4 

857 

1426 

4 

1580 

2629 

4 

2711 

2836 

4 

3293 

3514 

4 

3580 

3660 

4 

3691 

3888 

4 

4033 

4084 

4 

4309 

4442 

4 

4579 

4766 

4 

4952 

5131 

5 

0 

159 

5 

1958 

2267 

6 

4041 

4372 

5 

6254 

6410 

6 

1 

100 

6 

1043 

1966 

6 

2063 

3278 

6 

3876 

4692 

6 

6891 

6106 

7 

0 

276 

7 

1407 

1731 

7 

6259 

6434 

7 

7665 

8064 

7 

9264 

9468 

7 

11469 

11641 

7 

12822 

13165 

7 

14293 

14583 

7 

15695 

15953 

7 

36000 

60000 

Figure  1.  Contents  of  the  File  MAJABS.DAT  Which  Is  Used  To  Display  Re¬ 
gions  of  Active  Molecular  Absorption.  The  first  record  identifies  the  last  record 
of  absorption  data  for  each  molecule.  The  three  columns  of  subsequent  records 
represent  a  molecule  identification  number  (see  Table  3),  and  the  beginning  and 
ending  frequency  of  a  molecular  absorption  region. 
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8 

0 

98 

8 

1515 

2141 

8 

3280 

3991 

9 

0 

281 

9 

433 

617 

9 

1023 

1419 

9 

2463 

2526 

10 

1 

125 

10 

585 

986 

10 

1526 

1682 

10 

2803 

2938 

11 

0 

2166 

12 

0 

68 

12 

815 

920 

12 

1645 

1775 

Figure  1.  (Corn.) 


SEtiTRAti7  SUll4/Urmc  Version 


SPARTA  Inc 


DEVELOP  IBS  IHPOT  DECK 
BASED  OB  LAST  EDITING  SESSIOB 


COMPILING  TEST. IBP  AS  MESH  ERBLOC 
LIST  OF  ACTIVE  MOLECULAR  ABSORBERS  (Vis  1300.0  V2=  1305.0) 


H20 

ACTIVE 

REGIOBS : 

1300 . 0 

TO 

1305.0 

CM-1 

C02 

ACTIVE 

REGIONS : 

1300.0 

TO 

1305.0 

01-1 

B20 

ACTIVE 

REGIOBS : 

1300.0 

TO 

1305.0 

CM-1 

CH4 

ACTIVE 

REGIOBS: 

1300.0 

TO 

1305.0 

CM-1 

802 

ACTIVE 

REGIOBS : 

1300.0 

TO 

1305.0 

CM-1 

BH3 

ACTIVE 

REGIOBS : 

1300.0 

TO 

1305.0 

CM-1 

. . .MORE. . .  HIT  <RZTOBB>  TO  CONTINUE”] 


Figure  2.  Representative  Display  of  the  Major  Molecular  Absorbers  Used  in  a 
Given  SENTRAN7  Calculation 
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Table  4.  Plots  Available  From  SENTRAN7’s  Graph  and  Analyze  Module 


PLOT  CATEGORY* 

SPECIFIC  PLOTS 

Raw  -XYZ 

Transmittance 

Transmittance:  total,  log  of  total,  uniform  mixed  gases, 
trace  gases,  molecular  scattering,  H2O, 

HqO  continuum,  O3,  N2  continuum, 
aerosol  and  hydrometeor,  CO2,  CO,  CH4, 

n2o,  o2,  nh3,  no,  no2,  so2,  hno3 

Aerosol  and  Hydrometeor  Absorption 

Thermal  Radiance 

Transmittance:  total,  log  of  total 

Atmospheric  Radiance 

Differential  Transmittance 
and  Black  Body  Function 

Differential  Transmittance  (DTAU),  DTAU/layer  thickness 
DTAUx  black  body  function, 

DTAU  x  black  body  function/layer  thickness 

Fluxes/Irradiance 

Fluxes:  upward  total,  upward  solar,  downward  total, 
downward  solar 

Direct  Solar  Irradiance 

Solar/Lunar  Radiance 

Transmittance:  total,  log  of  total 

Radiance:  total,  atmospheric,  path  scattered, 

single  scattered,  total  ground  reflected, 
direct  reflected 

Direct  Solar  Radiance 

Transmittance:  total,  log  of  total,  solar  irradiance 

Incident  Solar  Irradiance 

*  Determined  By  Values  of  IEMSCT,  IMULT,  NOPRT  on  Card  1 


2.5  New  Features  in  SENTRAN7 

2.5.1  Compatibility  with  MODTRAN 

As  mentioned  in  Chapter  1,  a  new  feature  of  SENTRAN7  is  the  option  to 
perform  sensitivity  analyses  with  MODTRAN.  MODTRAN  is  an  “enhanced”  ver¬ 
sion  of  LOWTRAN7  that  can  compute  atmospheric  transmission  and  background 
radiance  at  resolutions  between  2  and  50  cm-1  Full-Width-at-Half-Maximum 
(FWHM).  This  improved  spectral  resolution  required  developing  a  completely  new 
two-parameter  band  model  algorithm;  while  MODTRAN  and  LOWTRAN  share 
common  I/O,  geometry  specifications,  aerosol  modules,  etc.,  the  two  codes  are  not 
sequentially  derivative,  (see  MODTRAN  documentation)  The  input  data  sequence 
for  MODTRAN  is  nearly  identical  to  LOWTRAN7,  although  an  additional  input 
parameter  on  Card  4,  IFWHM,  defines  the  FWHM  used  to  degrade  MODTRAN 
calculations  to  the  desired  spectral  resolution.  Also,  a  logical  variable,  MODTRN, 
has  been  added  at  the  beginning  of  Card  1  which  allows  MODTRAN  to  operate  as 
LOWTRAN7.  The  format  of  the  output  files  tape7  and  tape8  from  MODTRAN 


12 


is  the  same  as  that  from  LOWTRAN7.  The  MODTRAN  package  also  requires 
an  external  data  file  called  BMTAPE.DAT  which  contains  molecular  absorption 
parameters  (see  Section  2.3.3). 

The  ability  to  use  MODTRAN  is  integrated  into  SENTRAN7  without  compro¬ 
mising  flexibility  or  power.  The  methodology  files  developed  for  LOWTRAN7 
can  be  used  with  MODTRAN,  and  vice  versa.  Users  only  need  to  specify  which 
code  to  use,  and  SENTRAN7  then  internally  keeps  track  of  any  file  manipulation. 
When  going  from  LOWTRAN7  to  MODTRAN,  however,  users  are  reminded  to 
define  the  IFWHM  parameter  on  Card  4.  The  value  of  IFWHM  is  ignored  when 
the  user  selects  LOWTRAN7.  Since  SENTRAN7  uses  the  standard  input  and  out¬ 
put  format  from  LOWTRAN7,  minor  changes  to  MODTRAN’s  input  format  are 
required.  For  reference,  the  coding  changes  required  in  MODTRAN  are  given  in 
Appendix  B. 

2.5.2  Addition  Of  An  On-Line  Run  Module 

The  On-line  Run  Module  is  a  new  feature  designed  to  speed  up  a  SENTRAN7 
session.  In  the  original  SENTRAN  code,  users  had  to  exit  the  code  after  compiling 
an  input  file,  run  LOWTRAN  externally,  restart  SENTRAN,  and  then  enter  the 
Graph  and  Analyze  Module. 

The  On-line  Run  option  in  SENTRAN7  is  achieved  using  a  system-dependent 
Fortran  command  that  “spawns”  a  subprocess  to  the  computer’s  operating  sys¬ 
tem.  On  VAX/VMS  systems,  for  example,  LOWTRAN7  can  be  executed  with  the 
command: 

STATUS  =  LIB$SPAWN(‘run  lowtran7.exe’). 

Control  is  returned  to  SENTRAN7  when  the  subprocess  is  completed.  Additionally, 
SENTRAN7  has  included  an  option  that  allows  users  to  specify  the  directory  where 
the  executable  LOWTRAN7  and/or  MODTRAN  codes  reside.  To  do  this,  the 
us?*rs  can  manually  edit  the  SENTRAN7  file  called  DIRECT.ORY  which  contains 
the  directory  and  names  of  the  executable  codes,  as  well  as  the  location  of  the 
UFTAPE.DAT  file  for  MODTRAN.  If  DIRECT.ORY  does  not  exist,  SENTRAN7 
searches  its  own  directory  for  the  appropriate  files.  An  example  DIRECT.ORY  file 
has  been  included  with  the  SENTRAN7  package  (see  Section  3.4). 

2.5.3  Displaying  Available  Methodology  and  Other  Input  Files 

Another  new  feature  in  SENTRAN7  is  the  ability  to  display  available  method¬ 
ology  and  other  input  files  on  the  screen.  Effectively,  the  screen  display  is  ac¬ 
complished  by  spawning  a  subprocess  that  performs  a  “directory”  command  on  all 
files  with  a  common  extension.  SENTRAN7  displays  a  list  of  available  files  when 
users  do  not  enter  a  filename  ( i.e .,  pressing  RETURN  with  no  default  filename) 
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or  when  a  filename  that  does  not  exist  is  entered.  After  SENTRAN7  displays  the 
available  files,  users  can  type  the  file  they  want  at  the  bottom  of  the  screen  and 
then  press  RETURN.  This  feature  is  included  in  the  Load/Save  and  Edit  Modules 
where  users  must  specify  external  input  files  for  the  Card  2C,  2D,  and  3B  series. 
An  example  of  SENTRAN7  displaying  methodology  files  is  shown  in  Figure  3. 


CASED  .  MTH 
CASEOO.MTH 
CASEOA. MTH 
EASE*. MTH 


LiUlH/Um::  Version 


CHOOSE  OIIZ  or  THE  TOLLOWIHG.  HIT 

*  MTH 


SPARTA ,  Inc 


CABE4A.MTH 
CASE 5 . MTH 
CASE5A.HTH 
DETAOLT . MTH 


DTAO.WTH 
DTA03.MTH 
LAST. MTH 
MODEL.  MTH 


<ESTER>  TO  ESCAPE. 


MODEL1 . MTH 
TEST.  MTH 
TOTOR1 .MTH 
TOTOR2 . MTH 


FILE  NAME 


□ 


Figure  3.  A  Sample  SENTRAN7  Screen  Displaying  the  Available  Methodology 
Files 


2.5.4  Safeguards  to  Prevent  Existing  Files  From  Being  Overwritten 

SENTRAN7  includes  new  safeguards  to  prevent  existing  methodology  files  and 
LOWTRAN7  input  files  from  being  overwritten.  The  feature  is  operational  in  the 
Load/Save  and  Compile  Modules  when  users  are  prompted  for  a  filename.  Before 
creating  a  methodology  file  (any  file  with  the  .MTH  extension)  or  a  LOWTRAN  7 
input  file  (a  file  with  a  .INP  extension),  SENTRAN7  checks  the  current  directory 
to  see  if  the  specified  file  exists.  When  the  file  is  found  to  be  present,  a  screen 
message  will  appear  asking  the  user  if  the  file  can  be  replaced.  If  the  user  types 
‘n’,  then  the  user  is  asked  to  specify  a  different  filename.  An  example  of  this  new 
safeguard  feature  is  given  in  Figure  4. 
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SEHTRAII7  :  SUU4/Unix  Version 


SPARTA.  Inc 


DEVELOPING  INPUT  DECK 
BASED  ON  LAST  EDITING  SESSION 


ENTER  riLE  NAME  FOR  INPUT  DECK  [ .ISP] 
AND  SENTRAN7  COMPILE  OPTIONS 

TEST . INP 

TILE  NAME  EXISTS,  REPLACE  ?  [^] 


Figure  4.  A  Sample  SENTRAN7  Screen  Message  to  Warn  Users  Against  Writing 
Over  Files.  In  this  case,  the  user  is  reminded  that  the  file,  TEST.INP,  already  exists 

2.5.5  Increased  Portability  Across  Hardware  Platforms 

A  new  feature  of  SENTRAN7  is  the  capability  to  run  the  code  on  SUN 
Microsystems™  computers,  as  well  as  VAX/VMS  computer  systems.  Because 
some  new  features  in  SENTRAN7  require  system  calls,  the  system  dependent  sub¬ 
routines  were  removed  from  the  main  SENTRAN7  code  and  placed  in  separate 
files.  Thus  the  SENTRAN7  package  contains  two  files  called  senvms.for  and  se- 
nunix.f.  The  senvms.for  is  used  when  compiling  and  linking  on  VAX/VMS  systems 
and  senunix.f  on  SUN  systems.  Also,  the  current  file  organization  readily  allows 
for  SENTRAN7  to  be  adapted  to  other  operating  systems,  such  as  DOS  and  NOS. 
That  is,  users  need  only  develop  system  dependent  subroutines  that  perform  the 
same  actions  as  those  in  senvms.for  and  senunix.f. 

2.5.6  On-line  Help  Within  the  Edit  Module 

An  on-line  help  facility  has  been  added  to  SENTRAN7’s  Edit  Module.  This 
help  facility  provides  the  user  with  a  simple  and  fast  method  for  obtaining  general 
information  about  a  parameter  on  any  of  the  LOWTRAN7  input  cards.  While 
in  the  Edit  Module,  the  user  simply  types  ‘help’  on  the  line  being  edited,  and 
a  screen  containing  a  brief  description  of  that  particular  parameter  will  appear. 
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Specific  examples  are  given  in  the  Users  Guide  in  Chapter  4.  It  should  be  stressed 
that  this  on-line  help  facility  is  meant  only  to  be  a  quick  reference  into  parameter 
definitions  and  possible  values,  and  should  not  be  used  as  an  all-encompassing 
reference  to  the  LOWTRAN7/MODTRAN  variables.  The  user  is  instead  referred 
to  the  appropriate  manuals  for  LOWTRAN71  and  MODTRAN.4 

2.5.7  Tick  Marks  and  Labeling  of  Plots 

The  graphics  produced  by  SENTRAN7  have  been  improved  with  the  addition 
of  tick  marks  on  both  the  2D  and  3D  plots,  and  new  axis  labeling  at  the  bottom 
of  the  screen.  An  example  of  a  new  3D  plot  is  shown  in  Figure  5.  Along  with 
the  axis  tick  marks,  note  the  different  format  for  labeling  the  x,  y,  and  z  axes.  The 
axis  letter  (. x ,  y,  or  z)  is  given  first,  followed  by  the  parameter  plotted  on  that  axis. 
The  axis  range  is  then  displayed  along  with  the  delta  value  of  each  tick  mark.  If  a 
perturbation  list  was  used  for  a  parameter,  the  list  is  displayed  rather  than  the  axis 
range,  and  the  delta  value  of  each  tick  mark  is  not  displayed. 

2.5.8  Plot  Option  for  Trace  Gas  Profiles 

SENTRAN7  now  has  the  ability  to  plot  trace  gas  profiles  from  Card  2C  and 
their  perturbations.  This  option  has  been  imt  lemented  in  a  two-step  process.  The 
user  first  stores  the  trace  gas  profile,  and  its  perturbation  values,  if  any,  from  within 
the  Edit  Module  of  SENTRAN7.  Second,  the  user  plots  these  data  from  within 
the  Graph  and  Analyze  Module  of  SENTRAN7  by  choosing  to  plot  a  raw  x,  y,  z 
data  file  and  entering  the  name  of  the  file  created  within  the  Edit  Module.  A  more 
detailed  description  of  this  feature,  along  with  an  example,  is  given  in  the  Users 
Guide  in  Chapters  4  of  this  report. 
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X>N 


RANGE 

HI 

TOTAL  TRANSMITTANCE 


1.0000E+00  TO 
0.0000E+00  TO 
0 . 1700E-02  TO 


1.0000E+01  ( TICK=  1.0) 
2. 0000E  +  01  ( TICK=  2.0) 
0. 9836E+00  ( TICK=0 . 0981 ) 


Figure  5.  Example  of  a  3-D  Plot  Created  by  the  Graph  and  Analyze  Module  of 
SENTRAN7 
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3  INSTALLING  AND  RUNNING  SENTRAN7 


3.1  Overview  of  Software 

SENTRAN7  is  designed  to  be  highly  portable,  while  maintaining  a  reason¬ 
ably  high  level  of  performance.  These  goals  dictate  the  use  of  highly  portable 
code  and  common  standards  for  graphics  and  terminal  control.  Given  these  re¬ 
quirements,  SENTRAN7  is  coded  in  Fortran-77.  The  code  utilizes  the  Tektronix 
4010/4014  format  standards  for  graphics6  and  the  American  National  Standards 
Institute  (ANSI)  standard  for  terminal  control.7  Tektronix  4010/4014  was  selected 
because  it  is  probably  the  most  popular  graphics  format  to  be  emulated.  More¬ 
over,  graphics  and  terminal  control  kernels  in  SENTRAN7  are  completely  self 
contained,  obviating  the  need  for  external  software  libraries.  Digital  Equipment 
Corporation’s  VT240  terminal  (along  with  several  VT240  compatibles  available 
from  other  manufacturers)  supports  both  the  ANSI  and  TEK4010  standards,  so  it 
is  an  ideal  terminal  for  interactive  viewing  of  SENTRAN7  graphics.  It  is  noted 
that  the  VT240  is,  in  fact,  one  of  the  industry  standard  graphics  terminals. 

3.2  Installing  the  Program 

Table  5  lists  the  files  included  with  the  SENTRAN7  package.  To  install  the 
code,  first  create  a  subdirectory  to  contain  the  programs  and  data  files.  Once 
this  has  been  completed,  copy  the  files  from  the  distribution  media  into  the  target 
subdirectory. 

SENTRAN7  can  be  compiled  to  run  on  either  a  VAX/VMS™  system  or  Sun 
Microsystems™  computer.  The  following  instructions  explain  how  to  compile  and 
link  SENTRAN7: 

•  For  a  VAX/VMS  system,  type  ‘(©makefile’.  This  creates  the  executable 
file  sentran.exe. 

•  For  a  Sun  Microsystems  computer,  type  ‘make’.  This  creates  the  executable 
file  sentran.  Note  that  some  Sun  Microsystems  computers  will  generate  a 
series  of  warning  messages  during  compilation  which  can  be  ignored  by  the 
user. 

To  start  the  program,  the  user  simply  types  T  sentran’  if  on  a  VAX/VMS  system, 
or  ‘sentran’  if  operating  on  a  Sun  Microsystems  computer. 


6  Tektronix,  Inc.  (1977)  Users  Guide  and  Service  Manual  for  4014,  4014-1  Terminals,  Tek  Part 
No.  070-1647-00,  Beaverton,  OR. 

7  ANSI  Standard  X3.64  (1979)  Additional  Controls  for  Use  With  ASCII,  Secretariat:  CBEMA, 
1828  L  St.,  N.W.,  Washington,  DC. 
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Table  5.  Files  Included  with  the  SENTRAN7  Package 


FILE  NAME 

CONTENTS 

senmainfor 

Source  code  for  SENTRAN7  (main  program  only) 

sensubs.for 

Source  code  for  SENTRAN7  (other  routines) 

sennew.for 

Source  code  for  SENTRAN7  (routines  created  by  SPARTA) 

senvms.for 

Source  code  for  SENTRAN7  (VAX  computer  systems  only) 

senunix.f 

Source  code  for  SENTRAN7  (UNIX  computer  systems  only) 

MAJABSDAT 

Data  file  defining  regions  of  molecular  absorption 

DIRECTORY 

Configuration  file  containing  directory  and  name  of 
LOWTRAN7  and  MODTRAN  executables  and  the 
UFTAPE.DAT  file.  Current  directory  is  assumed  when 
DIRECT.ORY  does  not  exist 

SENTRAN.HLP 

SENTRAN7  on-line  help  utility  file 

MOD  ELI. PRO 

Tropical  atmosphere  profile  ( i.e Card  2C  series) 

MODEL2.PRO 

Midlatitude  summer  profile 

MODEL3.PRO 

Midlatitude  winter  profile 

MODEL4.PRO 

Subarctic  summer  profile 

MODEL5.PRO 

Subarctic  winter  profile 

M0DEL6.PR0 

U.S.  standard  profile 

SAMPLEAER 

Sample  Card  2D  series:  normalized  aerosol  extinction 
versus  wavelength  for  four  aerosol  regions 

SAMPLE.PHS 

Sample  Card  3B  series:  aerosol  phase  functions  for 
four  aerosol  regions 

DEFAULT.MTH 

Sample  methodology  file  (used  in  Tutorial  #1) 

lowtran7.for 

Source  code  for  LOWTRAN7 

modtran.for 

Source  code  for  MODTRAN 

mkbin.for 

Program  creates  UFTAPE.DAT  from  BMTAPEJDAT 

makefile.com 

Command  file  for  compiling  and  linking  SENTRAN7 
on  VAX/VMS  systems.  Type  ‘(©makefile’  to  execute 

makefile 

Unix  command  file  for  compiling  and  linking  SENTRAN7 
on  SUN  systems.  Type  ‘make’  to  execute 
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3.3  L0WTRAN7  and  MODTRAN  Requirements 

Source  codes  for  both  LOWTRAN7  and  MODTRAN  have  been  included  with 
this  distribution.  Slight  modifications  have  been  made  to  both  source  codes  in  or¬ 
der  to  run  with  SENTRAN7.  The  user  is  referred  to  Appendix  B  for  a  discussion 
of  the  changes.  Other  than  the  modifications  specified  here,  no  other  modifica¬ 
tions  to  either  LOWTRAN7  or  MODTRAN  are  allowed  if  they  are  to  work  with 
SENTRAN7. 

LOWTRAN7  has  been  modified  to  continue  layer-by-layer  calculations  even 
when  the  differential  transmittance  (DTAU)  has  become  very  small.  In  the  standard 
version  of  LOWTRAN7,  the  program  would  jump  out  of  the  calculation  loop 
when  DTAU  was  less  than  10“5.  For  SENTRAN7,  however,  the  complete  array 
of  DTAU  and  flux  data  must  be  included  in  tape8  to  avoid  empty  regions  or 
“gaps”  in  the  3D  plots  of  DTAU  and  flux  data.  For  reference,  these  code  changes 
are  given  in  Appendix  B.  The  code  changes  to  LOWTRAN7  are  included  with 
this  distribution.  Note  that,  the  changes  made  to  LOWTRAN7  are  recommended 
changes,  but  are  not  required  to  run  LOWTRAN7  with  SENTRAN7. 

MODTRAN  has  been  similarly  modified  in  order  to  continue  layer-by-layer 
calculations  even  when  DTAU  has  become  very  small.  In  addition,  because  the  in¬ 
put  structure  for  MODTRAN  is  slightly  different  from  LOWTRAN7,  MODTRAN 
must  be  modified  slightly  to  work  with  SENTRAN7.  For  reference,  these  code 
changes  are  also  given  in  Appendix  C.  The  modified  version  of  MODTRAN  is 
included  as  part  of  the  SENTRAN7  package  ( modtran.for ).  Note  that,  the  changes 
made  to  MODTRAN  are  required  in  order  for  MODTRAN  to  work  with  SEN- 
TRAN7. 

3.4  Using  the  DIRECT  ORY  File 

The  DIRECT.ORY  file  allows  users  to  specify  the  directory  where  the  exe¬ 
cutable  codes  for  LOWTRAN7  and  MODTRAN  reside.  A  sample  DIRECT.ORY 
file  has  been  included  with  the  SENTRAN7  package.  SENTRAN7  uses  this  file 
to  locate  the  executable  code  for  the  transmission  model  chosen  by  the  user.  The 
file,  DIRECT.ORY ,  should  be  edited  with  a  standard  text  editor  on  the  user’s  com¬ 
puter  system  to  indicate  the  directories  and  names  of  the  executable  codes  for 
LOWTRAN7  and  MODTRAN,  as  well  as  the  location  of  MODTRAN’s  molecular 
absorption  data  file  called  UFTAPE.DAT.  Note  that  if  DIRECT.ORY  does  not  exist, 
SENTRAN7  searches  the  current  directory  for  the  appropriate  files. 
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4  USERS  GUIDE  FOR  SENTRAN  7 

This  users  guide  is  targeted  at  both  novice  and  experienced  SENTRAN7  users, 
and  provides  an  overview  of  SENTRAN7’s  structure  and  usage.  Details  of  com¬ 
mand  usage  in  a  quick  reference  format,  may  be  found  in  Appendix  C.  Recall  that 
SENTRAN7  can  execute  either  LOWTRAN7  or  MODTRAN.  Unless  explicitly 
stated,  the  use  of  the  term  LOWTRAN7  will  imply  reference  to  both  LOWTRAN7 
and  MODTRAN. 

4.1  Overview  of  SENTRAN7 

A  brief  overview  of  SENTRAN7  is  given  in  this  section  for  users  who  are  not 
familiar  with  the  original  SENTRAN  code.  Users  who  are  familiar  with  the  features 
of  the  original  SENTRAN  may  skip  this  section  and  proceed  to  Section  4.2. 

4.1.1  Code  Philosophy 

SENTRAN7  is  a  general  purpose  computer  code  that  facilitates  the  analysis  of 
LOWTRAN7’s  response  to  the  perturbation  of  its  input  parameters.  SENTRAN7 
is  primarily  designed  as  a  comfortable,  interactive  interface  to  LOWTRAN7  with 
special  provisions  for  perturbation  analysis.  Using  SENTRAN7,  one  can  easily 
extract,  analyze,  reduce,  and  plot  LOWTRAN7  data.  These  features  permit  users 
to  rapidly  perform  analyses  that  would  be  difficult  or  impossible  through  brute-force 
techniques.  The  process  is  highly  automated  and  requires  little  effort  on  the  part  of 
the  user  because  SENTRAN7  is  “intelligent”  enough  to  keep  track  of  the  details  of 
parameter  variation.  Also,  SENTRAN7  contains  many  useful  analysis  tools  such 
as  evaluating  partial  derivatives  of  a  variable  represented  by  the  z  axis  with  respect 
to  two  independent  variables  given  by  the  x  and  y  axes.  Using  these  capabilities, 
users  can  rapidly  determine  those  regions  where  LOWTRAN7’s  calculations  are 
most  sensitive. 

SENTRAN7  makes  extensive  use  of  graphics  to  display  results.  The  human  eye 
possesses  strong  abilities  with  respect  to  trend  analysis  and  can  identify  complicated 
patterns  at  a  glance.  These  capabilities  are  fully  exploited  in  SENTRAN7  via  the 
use  of  3D  surface  plots,  enabling  users  to  visualize  LOWTRAN7’s  response  to  the 
simultaneous  variation  of  two  parameters.  These  plots  can  be  archived  as  files  for 
hard-copy  generation  and/or  later  perusal  on  a  graphics  terminal. 

4.1.2  Design  Criteria 

The  design  of  SENTRAN7  was  based  on  the  following  general  criteria: 

1.  User  friendliness 

2.  Framework  for  sensitivity  analyses 

3.  High  portability 
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4.  Quick  turnaround  time  for  interactive  analyses 

5.  Extensive  use  of  graphics  for  data  presentation 

6.  Provisions  for  data  analysis  and  reduction  tools. 

User  friendliness  is  one  of  the  single  greatest  considerations  in  SENTRAN7’s 
design.  Most  of  SENTRAN7  is  devoted  to  providing  users  with  a  comfortable 
working  environment,  without  compromising  flexibility  or  power.  User  friendliness 
is  implemented  in  a  number  of  ways,  including: 

1.  The  code  is  virtually  crash  proof,  using  character  oriented  input  for  com¬ 
mand  strings  and  numerical  values.  Before  being  accepted,  numerical  inputs 
are  examined  to  make  sure  they  are  physically  meaningful. 

2.  Commands  can  be  entered  in  upper,  lower,  or  mixed  case. 

3.  Abundant  feedback  is  provided,  including  step-by-step  prompts  and  ample 
information  when  the  code  cannot  properly  read  user-specified  input  files. 

4.  The  command  interpreter  can  resolve  the  component  parts  of  complicated 
input  strings,  bypassing  input  prompts,  thus  permiting  veteran  users  to  use 
the  code  with  increased  speed. 

5.  Sensible  defaults  are  provided  wherever  possible,  reducing  the  chance  of 
erroneous  input. 

6.  On-line  help  is  available,  minimizing  the  amount  of  time  required  to  learn 
how  to  use  SENTRAN7.  The  help  feature  also  provides  information  on 
LOWTRAN7  inputs. 

While  this  list  is  by  no  means  complete,  it  provides  an  idea  of  the  user  friendly 
features  of  SENTRAN7.  Collectively,  these  features  eliminate  the  need  to  concen¬ 
trate  on  file  and  data  manipulation  so  users  can  focus  on  the  scientific  aspects  of 
their  LOWTRAN7  analysis  problems. 

Another  important  requirement  is  the  ease  and  speed  of  post-processing  of 
LOWTRAN7  outputs.  SENTRAN7  tries  to  isolate  LOWTRAN7  from  the  user  as 
much  as  possible  so  that  the  user  need  not  be  aggravated  by  bookkeeping.  It  can 
extract  transmittance  and/or  radiance  data  from  LOWTRAN7’s  tape7  and  tape8 
output  files.  Also,  SENTRAN7  is  intelligent  enough  to  prompt  the  user  with  the 
list  of  input  parameters  that  can  be  chosen  as  independent  variables  for  plotting 
and  derivative  computation. 

Data  analysis  and  reduction  tools  are  provided  along  with  graphics  in  an  in¬ 
teractive  module.  The  analysis  tools  include  common  data  manipulations  such  as 
logarithmic  transformation  of  data  and  partial  derivatives  of  first  and  second  or¬ 
der  with  respect  to  the  independent  axes.  Furthermore,  SENTRAN7  can  read  and 
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plot  raw  data  files  as  well  as  output  the  reduced  data  as  raw  data  files  for  use  in 
commercial  plotting  packages. 

4.2  Program  Structure 

SENTRAN7  is  structured  into  a  number  of  subprograms  called  modules.  Each 
module  performs  a  specific  task  to  aid  users  in  their  sensitivity  studies.  The  modules 
are  ordered  according  to  the  way  users  would  typically  conduct  a  sensitivity  study. 
The  seven  main  modules  of  SENTRAN7  are  listed  in  Table  6.  The  SENTRAN7 
Main  Menu  is  shown  in  Figure  6.  The  following  sections  provide  specific  details 
on  how  to  use  each  of  the  SENTRAN7  modules. 

4.2.1  Help  Module 

On-line  help  is  available  at  almost  all  locations  within  the  SENTRAN7  pro¬ 
gram.  Specifically,  help  information  is  available  at  the  Main  Menu,  within  the  Edit 
Module,  and  within  the  Graph  &  Analyze  Module  of  SENTRAN7.  At  the  Main 
Menu,  users  can  obtain  general  information  about  most  of  SENTRAN7’s  modules 
listed  in  Table  6.  To  access  this  information,  the  user  enters  the  command  ‘help’ 
followed  by  a  module  name  when  at  the  Main  MenL  Screen.  For  example,  the  user 
could  enter  ‘help  load’  for  a  description  of  the  LOAD  command.  In  the  absence  of 
a  module  name,  an  introductory  help  screen  appears  which  displays  a  list  of  help 
topics  (see  Figure  7).  Users  can  then  enter  the  name  of  a  selected  topic,  whereupon 
they  will  receive  help  on  that  particular  topic.  If  the  user  does  not  select  a  topic,  or 
selects  an  invalid  topic,  control  will  return  to  the  Main  Menu.  This  general  Help 
Module  has  not  been  updated  yet  to  supply  information  on  the  new  Select  and  Run 
Modules  of  SENTRAN7.  On-line  help  is  also  available  in  the  Edit  Module  and 
the  Graph  and  Analyze  Module  of  SENTRAN7.  These  on-line  help  capabilities 
are  described  in  greater  detail  in  Sections  4.2.3.5  and  4.2.7.5,  respectively. 

4.2.2  Load/Save  Module 

In  SENTRAN7,  images  of  LOWTRAN7  input  parameters  and  commands  for 
their  perturbation  are  contained  in  files  known  as  “methodology”  files.  These 
files  are  stored  on  the  host  computer  with  MTH  extensions.  Methodology  files 
enable  users  to  store  various  methodologies  and  use  them  as  starting  points  for 
new  experiments.  A  more  detailed  description  of  a  methodology  file  is  given  in 
Appendix  A. 

The  Load/Save  Module  is  where  users  can  load  and  save  selected  methodology 
files.  To  load  a  methodology  file,  the  user  enters  ‘1’  or  ‘load’  at  the  Main  Menu 
prompt.  If  the  user  enters  ‘1’,  SENTRAN7  will  ask  the  user  whether  they  want 
to  load  or  save  a  methodology  file.  The  user  then  enters  ‘load’  or  simply  ‘I’, 
in  order  to  load  a  file.  The  program  will  then  display  a  list  of  all  files  with  a 
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Table  6.  List  of  SENTRAN7  Modules 


MODULE 

MAIN  FUNCTION 

Help 

Provides  help  for  SENTRAN7  users 

Load/Save 

Loads  and  saves  SENTRAN7  methodology  files 

Edit 

Permits  users  to  define  their  LOWTRAN7  problems, 
including  atmospheric  inputs  and  commands  for 
their  perturbation 

Compile 

Creates  LOWTRAN7  input  file  based  on  editing  session  and 
displays  major  molecular  absorbers 

Select 

Selects  code  to  be  used:  LOWTRAN7,  MODTRAN  or 
MODTRAN  run  as  LOWTRAN7 

Run 

Executes  selected  code,  and  creates  LOWTRAN7’s  tape7 
and  tape8  files 

Graph  and  Analyze 

Extracts  output  data,  analyzes  and  graphs,  and  reduces  data  I/O 

SKHTRAN7  Version  SPARTA  Iir: 


WELCOME  TO  8EETRAE7 

THE  8E8BITIVITY  ANALYSIS  PROGRAM  FOR  LOWTRAR7/MODTRAR 

1  -  LOAD /SAVE 

2  -  EDIT 

3  -  COMPILE 

4  -  SELECT  LOWTRAH7 /MODTRAH 

5  -  BOH  LOMTRAH7 

S  -  GRAPH  S  ANALYZE 

7  -  HELP 

8  -  QUIT 

1] 


Figure  6.  SENTRAN7  Main  Menu 
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SEMTRAII7  SUIJ4  /  Uni::  Version  SPARTA,  Inc 


SENTRAH7  ONLINE  HELP  UTILITY 
HELP  18  AVAILABLE  ON  THE  FOLLOWING  TOPICS  : 
LOAD  SAVE  EDIT 

COMPILE  GRAPH  ANALYZE 
SEARCH  ZAP  LOG 


ENTER  THE  NAME  or  THE  SUBJECT  FOR  WHICH  YOU  NEED  HELP 
OR  PRESS  <RETURN>  TO  RETURN  TO  MAIN  PROGRAM 

NOTE:  THE  HELP  COMMAND  ACCEPTS  THE  ABOVE  ITEMS  AS 

ARGUMENTS,  BYPASSING  THIS  SCREEN 
EXAMPLE:  HELP  EDIT 

□ 


Figure  7.  The  Introductory  Help  Screen  in  the  Help  Module 

MTH  extension  present  in  the  current  directory  and  will  prompt  the  user  for  the 
file  name  to  load.  If  the  user  knows  which  methodology  file  they  wish  to  load 
at  the  Main  Menu,  several  steps  can  be  saved  by  simply  entering  ‘load  filename ’ 
at  the  Main  Menu  prompt,  where  filename  is  the  methodology  file  name  to  load 
into  SENTRAN7.  Recall  that  a  .MTH  extension  is  presumed  on  methodology  files 
unless  the  user  specifies  a  different  extension.  For  example,  typing  ‘load  example’ 
will  load  a  file  named  EXAMPLE  MTH,  while  typing  ‘load  wierd.ext’  will  load  a 
file  named  WIERD.EXT. 

Similarly,  if  the  user  wishes  to  save  the  current  values  of  all  the  parameters 
set  within  the  Edit  Module,  to  a  methodology  file,  the  user  enters  ‘1’  or  ‘save’  at 
the  Main  Menu  prompt.  If  the  user  enters  ‘I’,  save  option  must  be  selected.  The 
user  is  then  prompted  for  the  name  of  the  methodology  file  to  save  the  current 
parameter  values  in.  This  file  is  also  given  a  .MTH  default  extension  unless  a 
different  extension  is  specified  by  the  user.  If  the  file  already  exists,  the  user  must 
confirm  that  the  file  is  to  be  overwritten.  If  the  user  enters  ‘n’,  program  control  will 
be  returned  to  the  Main  Menu  and  the  methodology  file  will  not  be  overwritten. 
Saving  methodology  files  allows  the  user  to  easily  restore  the  parameters  used  for 
a  given  simulation. 

It  is  worth  noting  that  the  current  values  of  the  parameters  set  within  the  Edit 
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Module  are  saved  to  a  special  file,  LAST.MTH ,  after  every  completed  editing  session 
(i.e.,  an  editing  session  in  which  the  user  does  not  proceed  to  the  Main  Menu  via  the 
END  command)  and  after  every  compilation.  This  file  is  loaded  into  SENTRAN7  at 
the  beginning  of  the  next  SENTRAN7  session  and  provides  a  default  methodology 
for  the  session.  Therefore,  users  are  cautioned  against  saving  methodology  files 
named  LAST.MTH ,  or  tampering  with  the  LAST.MTH  file  in  any  way. 

4.2.3  Edit  Module 

The  Edit  Module  of  SENTRAN7  provides  a  flexible  means  of  defining  LOW- 
TRAN7  input  cards.  The  SENTRAN7  editor  permits  the  entry  of  atmospheric  data 
and  commands  for  data  perturbation.  The  user  is  reminded  that  LOWTRAN7’s 
input  philosophy  is  based  on  “cards”  of  data.  Each  “card”  relates  to  data  or  op¬ 
erating  conditions  of  a  specific  type.  SENTRAN7  retains  the  LOWTRAN7  input 
card  philosophy  and  SENTRAN7’s  editor  emulates  LOWTRAN7’s  logical  flow 
through  the  input  card  images. 

4.2.3.1  Using  the  Edit  Module 

To  enter  the  editor,  the  user  should  enter  ‘2’  or  ‘edit’  at  the  Main  Menu  prompt. 
The  SENTRAN7  Edit  Module  then  provides  the  user  with  a  series  of  screens  from 
which  the  user  can  set  up  or  edit  the  simulation  conditions.  Figure  8  provides  an 
example  of  a  screen  displayed  while  editing  a  LOWTRaN7  “card.”  The  example 
is  for  Card  1  of  the  LOWTRAN7  input  cards.  The  name  of  the  current  card  image 
appears  at  the  top  of  the  editing  screen,  while  the  name  of  the  LOWTRAN7  input 
variables  appear  along  the  left  hand  column.  Values  for  each  of  the  LOWTRAN7 
inputs  appear  to  the  immediate  right  of  the  list  of  names,  along  with  any  pertur¬ 
bation  instructions.  The  terminal’s  cursor  will  appear  to  the  left  of  the  variable 
which  is  currently  being  edited,  and  data  entry  is  accomplished  by  typing  over  the 
current  field.  In  Figure  8,  MODEL  is  the  parameter  currently  being  edited.  Vari¬ 
ables  that  are  marked  with  an  are  subject  to  certain  restrictions.  As  discussed 
in  Section  2.2,  the  input  parameters  marked  with  an  in  the  Edit  Module,  can¬ 
not  be  perturbed  in  some  cases  because  their  perturbation  creates  different  flows 
through  the  input  card  images.  These  input  parameters  have  been  previously  listed 
in  Table  1 . 

4.2J.2  Movement  Through  the  Edit  Module 

In  the  Edit  Module,  the  user  hits  RETURN  to  move  down  the  current  card 
image,  line-by-line.  In  addition,  there  are  several  input  strings  that  SENTRAN7 
reserves  for  cursor  control.  These  commands  are  listed  in  Table  8.  Note  in  Table  8, 
that  the  “n”  values  are  optional,  and  their  absence  implies  n=l. 
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Figure  8.  An  Example  of  a  Screen  from  SENTRAN7  Editing  Module 


Table  7.  List  of  Cursor  Control  Commands  in  the  Edit  Module  of  SENTRAN7 


COMMAND 

ACTION 

up  n1 

Move  cursor  up  n  lines 

dn  n 

Move  cursor  down  n  lines 

pu 

Move  to  previous  major2  card  image 
(PAGE  UP) 

pd 

Move  to  next  major  card  image 
(PAGE  DOWN) 

end 

End  editing  session,  goto  Main  Menu 

1  n  is  optional;  its  absence  means  n  =  1 

2  Major  cards  are  Card  1,  2,  3,  4 
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While  in  the  Edit  Module,  the  user  can  use  the  “UP”  command  to  go  back, 
to  a  previous  parameter.  Simply  typing  ‘up’  and  RETURN  will  move  the  cursor 
up  one  line.  To  move  back  more  than  one  line,  the  user  should  enter  ‘up’  and 
the  number  of  lines  to  move.  For  example,  the  command,  ‘up  2’,  will  move  the 
cursor  back  two  lines.  Similarly,  to  move  ahead,  the  user  should  enter  the  “down” 
command,  ‘dn’,  and  the  number  of  lines  to  move  down  (if  greater  than  one). 

If  the  user  has  made  all  the  necessary  changes  to  a  card  and  wants  to  move 
quickly  to  the  next  card  image,  the  “PAGE  DOWN”  command,  ‘pd’,  is  used. 
Before  proceeding  to  the  next  card  image,  the  user  will  be  prompted  to  check  that 
all  the  parameters  on  the  current  card  have  been  set  as  desired.  Similarly,  if  the 
user  wants  to  move  back  to  the  previous  card  image,  the  PAGE  UP  command, 
‘pu’,  is  used.  This  command  will  move  the  user  to  the  previous  major  card  image. 
Note  that  the  major  cards  are  Cards  1,  2,  3,  and  4.  To  quickly  end  the  editing 
session,  the  user  enters  ‘end’  and  RETURN.  The  user  is  then  returned  to  the  Main 
Menu. 

As  editing  is  taking  place,  the  user  will  notice  that  some  LOWTRAN7  input 
cards  and  some  variables  within  a  card  will  not  be  made  available  for  editing. 
Instead,  the  cursor  will  skip  over  certain  parameters  or  certain  input  cards  will  not 
be  displayed.  This  is  because  SENTRAN7’s  editor  emulates  LOWTRAN7’s  flow 
through  input  cards.  Specifically,  some  LOWTRAN7  parameters  are  not  available 
unless  certain  other  conditions  have  already  been  set.  For  example,  on  Card  1 ,  if  the 
execution  mode  parameter  (IEMSCT)  is  set  for  transmittance  mode  (IEMSCT=0) 
or  directly  transmitted  solar  irradiance  (IEMSCT=3),  then  multiple  scattering  is 
not  allowed.  Therefore,  the  IMULT  parameter,  which  specifies  multiple  scattering, 
is  set  to  zero  and  SENTRAN7  does  not  let  the  user  edit  this  parameter.  This 
feature  aids  the  user  by  eliminating  unnecessary  and  potentially  misleading  inputs. 
In  addition,  the  user  is  not  asked  to  edit  certain  cards  unless  they  are  needed.  For 
example,  Card  2C  is  not  edited  unless  the  model  parameter  is  set  for  meteorological 
data  (MODEL=0)  or  a  new  model  atmosphere  (MODEL=7)  and  radiosonde  data 
are  to  be  read  in  at  execution  time  (IM=1).  This  again  eliminates  unnecessary 
input  and  serves  as  a  form  of  debugging  tool,  in  that  the  user  who  wants  to  edit 
a  certain  card  image  is  first  forced  to  set  the  appropriate  flag  on  a  previous  card 
image  as  required  by  LOWTRAN7. 

It  is  important  to  note  that  if  the  user  tries  to  move  up  or  down  via  the  ‘up’ 
and  ‘dn’  commands  to  a  line  that  cannot  be  edited,  the  cursor  will  not  move  from 
the  current  line.  The  user  must  enter  a  number  of  lines  to  move  with  the  ‘up’  and 
‘dn’  commands  so  that  the  cursor  will  be  placed  on  a  line  that  can  be  edited. 

After  each  card  has  been  edited,  the  user  is  prompted  to  check  that  all  the 
parameters  for  that  card  have  been  set  as  desired,  as  shown  in  Figure  9.  Before 
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proceeding  ic  the  next  card  image,  the  user  should  check  the  values  set  for  the 
current  card.  If  the  user  wants  to  change  a  value,  the  user  can  enter  ‘n’  to  return 
to  the  top  of  the  card  being  edited.  If  the  user  accepts  the  default  ‘y\  the  screen 
is  updated  to  display  the  next  card  image  to  be  edited. 


Figure  9.  Prompt  to  Check  the  Variables  on  a  Given  LOWTRAN7  Input  Card. 
The  example  given  is  for  Card  1 


4. 2.3.3  Data  Entry  in  the  Edit  Module 

Entry  at  each  line  of  a  card  image  consists  of  two  elements.  The  first  is 
known  as  the  nominal  value,  while  the  second  is  known  as  a  perturbation  directive. 
The  nominal  value,  in  the  absence  of  a  perturbation  directive,  is  the  value  which 
SENTRAN7  passes  to  LOWTRAN7  upon  execution.  The  perturbation  directive 
is  a  statement  which  is  interpreted  by  SENTRAN7’s  Compiler  Module  to  produce 
a  sequence  of  values  to  use  for  that  particular  parameter  during  a  LOWTRAN7 
run.  The  nominal  value,  in  the  presence  of  a  perturbation  directive,  is  the  value 
perturbed. 

Data  entry  is  accomplished  by  simply  typing  over  the  current  field.  Note  that 
SENTRAN7  is  case  insensitive  and,  therefore,  data  entry  can  be  accomplished  in 
either  lower  or  upper  case.  After  the  input  line  is  entered,  SENTRAN7  internally 
converts  the  string  to  upper  case  and  displays  the  line  in  a  special  format,  insuring 
an  organized  appearance  for  the  editing  screens. 
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4.2.3.4  Perturbing  Data  in  the  Edit  Module 

SENTRAN7  permits  symbolic  manipulation  of  input  card  variables  through  a 
simple  interpreted  language  data  entry  format.  Five  basic  perturbation  syntaxes 
are  supported,  each  possessing  a  different  physical  interpretation,  allowing  the  user 
to  select  the  syntax  which  best  fits  the  user’s  needs.  The  syntaxes  supported  are 
shown  in  Table  8.  The  nominal  value  is  the  first  value  entered  in  the  command. 
Terms  appearing  in  square  brackets  “[]”  in  Table  8  are  optional.  The  ‘%’,  *+/-’, 
‘TO’,  and  V  terms  are  actual  elements  within  the  command  string.  Type  these 
commands  exactly  as  they  appear.  Examples  of  the  perturbation  commands  and 
how  they  can  be  used,  are  shown  in  Table  9.  (Note  that  these  perturbations  are  not 
limited  to  the  parameters  shown  in  Table  9.  These  parameters  were  chosen  only  to 
give  specific  examples  of  how  each  of  the  perturbation  commands  can  be  used.) 

Table  8.  List  of  SENTRAN7  Perturbation  Directive  Syntaxes  in  the  Edit  Module 


TYPE  OF 

PERTURBATION 

SYNTAX  FORMAT 

nominal  value  %value 

+/- 

nominal  value  +/-  value 

Iteration 

nominal  value  [start  P  TO  final  [STEP  n] 

List 

nominal  value  value 2  valued  ... 

Use  Previous 

nominal  value  * 

1  On  Card  2C  and  2D,  a  nominal  value  is  not  allowed  with  a  percent  perturbation 

2  Terms  in  “[  ]”  are  optional 


To  produce  a  percent  perturbation  of  a  parameter,  the  user  first  types  a  nominal 
value  followed  by  a  *%’  sign  and  the  amount  of  the  percent  perturbation.  For 
example,  to  perturb  the  parameter  HI  on  Card  3,  with  a  nominal  value  of  5.0  by 
20  percent,  the  user  would  enter  the  command  ‘5.0  %20\  as  shown  in  the  first 
example  in  Table  9.  When  compiled,  the  input  file  contains  LOWTRAN7  input 
conditions  for  the  HI  parameter  at  4.0,  5.0,  and  6.0  km.  Note  that  for  Cards  2C 
and  2D,  where  only  percent  perturbations  are  allowed,  the  user  does  not  enter  a 
nominal  value.  Instead,  the  user  need  only  enter  *%’  followed  by  the  amount 
of  the  desired  percent  perturbation.  The  nominal  values  are  read  from  the  input 
files  provided  for  Cards  2C  and  2D,  the  trace  gas  and  aerosol  attenuation  profiles, 
respectively. 
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Table  9.  Examples  of  Perturbation  Directives 


SAMPLE 

PARAMETER 

PERTUBATION 

DIRECTIVE 

SEQUENCE 

PRODUCED 

HI 

5.0  7c 20 

4.0,  5.0,  6.0 

H2 

8.0  +/-  2 

6.0,  8.0,  10.0 

ANGLE 

45.0  TO  47 

45.0,  46.0,  47.0 

RANGE 

10.0  TO  20  STEP  5 

10.0,  15.0,  20.0 

VIS 

5.0  0  TO  10  STEP  5 

0.0,  5.0,  10.0 

MODEL 

4  3  6 

4,  3,  6 

The  second  perturbation  type  allows  the  user  to  explicitly  specify  an  offset  to 
the  nominal  value.  In  this  case,  the  user  enters  the  nominal  value  and  then  ‘+/*’ 
followed  by  the  offset  value.  For  example,  to  perturb  the  parameter  H2  on  Card  3 
with  a  nominal  value  of  8.0  by  ±  2,  the  user  would  enter  ‘8.0  +/-  2\  as  shown 
in  the  example  in  Table  9.  This  command  would  produce  the  sequence  “6.0,  8.0, 
10.0”  for  the  H2  parameter. 

The  user  can  also  specify  an  iterative  perturbation  by  entering  a  start  and  final 
value  and  a  step  size,  with  the  default  step  size  being  equal  to  one.  One  example 
of  this  type  of  perturbation  is  shown  in  Table  9  for  the  ANGLE  parameter  on 
Card  3.  For  example,  if  the  user  enters  the  command  ‘45.0  TO  47’  for  the  ANGLE 
parameter,  LOWTRAN7  will  perform  calculations  with  the  parameter  ANGLE  set 
at  45.0,  46.0,  and  47.0  degrees.  The  user  can  also  explicitly  specify  a  step  size 
for  the  iterative  perturbation,  as  shown  in  the  example  in  Table  9  for  the  RANGE 
parameter  on  Card  3.  In  this  example,  the  user  would  enter  ‘10.0  TO  20  STEP 
5’,  to  produce  the  sequence  “10.0,  15.0,  20.0”.  Note  that  the  nominal  value  for 
the  iterative  perturbation,  can  be  different  than  the  start  value  of  the  iteration.  An 
example  of  this  is  shown  for  the  VIS  parameter  in  Table  9.  In  this  example,  the 
user  would  specify  a  nominal  value  of  5.0km  for  the  visibility  (the  VIS  parameter 
on  Card  2),  and  then  perturbs  the  parameter  from  0  to  10km,  in  steps  of  five.  The 
command  the  user  enters  is  ‘5.0  0  TO  10  STEP  5’.  The  benefits  of  specifying  a 
different  nominal  value  will  become  clear  when  the  compiler  options  are  explained 
in  Section  4.2.4.2.  Briefly,  the  NOMESH  option  of  the  SENTRAN7  compiler, 
perturbs  one  parameter  at  a  time,  holding  all  other  parameters  fixed  at  their  nominal 
values.  In  the  example  given  here,  the  VIS  parameter  will  be  held  constant  at  5.0 
while  other  parameters  are  perturbed.  If  the  user  had  entered  ‘0  TO  10  STEP  5’ 
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for  the  VIS  parameter,  with  no  nominal  value  specified,  then  the  VIS  parameter 
would  be  held  constant  at  0.0  while  other  parameters  were  perturbed,  if  compiled 
with  the  NOMESH  option.  Thus,  the  user  may  want  the  nominal  value  to  be 
different  then  the  starting  value  of  the  iteration. 

The  fourth  type  of  perturbation  is  to  enter  a  specific  list  of  values.  In  this 
case,  the  user  would  simply  type  in  the  values  to  use,  separated  by  spaces.  This  is 
shown  in  an  example  in  Table  9  for  specifying  different  model  atmospheres  using 
the  MODEL  parameter  from  Card  1 . 

The  last  type  of  perturbation  listed  in  Table  8  allows  the  user  to  change  the 
nominal  value  of  a  parameter,  but  keep  the  old  perturbation  for  that  parameter. 
The  user  should  enter  the  new  nominal  value  followed  by  a  V.  For  example,  to 
change  the  nominal  value  of  a  particular  parameter  to  5.0,  but  keep  the  previously 
specified  perturbation  directive,  the  user  should  enter  ‘5  An  example  of  this 
command  is  not  shown  in  Table  9  because  the  sequence  produced  with  this  type 
of  perturbation  depends  on  the  previously  set  perturbation  directive. 

It  should  be  noted  that  the  Edit  Module  checks  that  the  nominal  value  entered 
by  the  user  is  within  the  allowable  range  for  that  particular  parameter.  This  is 
done  after  the  user  presses  return.  If  the  value  entered  by  the  user  is  out  of  range, 
SENTRAN7  sets  the  nominal  value  to  the  nearest  value  within  range.  The  user  is 
cautioned  that  no  warning  message  is  given,  therefore  it  is  important  that  the  user 
verify  each  line  after  it  has  been  entered.  Although  the  Edit  Module  checks  the 
nominal  value,  it  does  not  check  that  the  perturbed  values  for  a  particular  parameter 
are  physically  meaningful  and  within  range.  The  perturbation  values  will,  instead, 
be  checked  within  the  Compiler  Module  which  will  issue  a  warning  to  the  user  at 
that  time. 


4.2.3.S  On-line  Help  Utility  Within  the  Edit  Module 

A  help  utility  has  been  added  to  the  Edit  Module  of  SENTRAN7.  This  help 
facility  provides  the  user  with  a  simple  and  fast  method  for  obtaining  general 
information  about  a  parameter  on  any  of  the  LOWTRAN7  input  cards.  While  in 
the  Edit  Module,  the  user  simply  types  ‘help’  on  the  line  being  edited,  and  a  screen 
containing  a  brief  description  of  that  particular  parameter  will  appear.  Figure  10 
shows  an  example,  when  the  user  types  ‘help’  while  editing  the  MODEL  parameter 
on  Card  1.  It  should  be  stressed  that  this  on-line  help  facility  is  meant  only  to 
be  a  quick  reference  into  parameter  definitions  and  possible  values  and  should  not 
be  used  to  understand  the  overall  meaning  of  the  LOWTRAN7  variables.  The 
user  is,  instead,  referenced  to  the  appropriate  user  guides  for  LOWTRAN71  and 
MODTRAN.4 
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=  0  METEOROLOGICAL  DATA  (HORIZONTAL  PATH  ONLY) 

1  TROPICAL  ATMOSPHERE 

2  MIDLATITUDE  SUMMER 
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6  1976  U.S.  STANDARD  ATMOSPHERE 

7  NEW  MODEL  ATMOSPHERE  (OR  RADIOSONDE  DATA) 


HIT  <RETURN>  TO  CONTINUE 


Figure  10.  On-line  Help  Screen  Within  Editing  Module  of  SENTRAN7.  (Note 
that  the  help  screen  does  not  appear  as  a  partial  overlay  during  execution  as  shown 
in  this  figure,  but  rather  covers  the  entire  screen) 

4.2J.6  Notes  About  the  Edit  Module 

It  is  important  to  note  that  SENTRAN7  often  rounds  off  numbers  incorrectly 
when  displaying  nominal  values  in  the  Edit  Module.  This  is  due  to  the  rounding 
procedure  used  in  the  Edit  Module’s  output  format  routine.  That  is,  SENTRAN7 
utilizes  internal  character  manipulation  routines  which  mimic  Fortran  format  state¬ 
ments,  permitting  flexible  reformatting  and  mixing  of  character  and  numerical  data. 
Often,  SENTRAN7  will  display  a  number  incorrectly,  terminating  the  number  with 
a  set  of  trailing  9’s.  For  example  the  value  70  may  be  displayed  as  69.99.  While 
this  problem  may  be  disconcerting  {i.e.,  the  number  typed  is  not  the  number  ob¬ 
served)  the  internal  representation  of  the  number  is  correct  and  the  bug  can  safely 
be  ignored.  An  example  of  this  is  shown  in  the  tutorials  in  Chapter  5. 
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4.2.4  Compile  Module 

Once  data  have  been  entered  or  edited,  it  must  be  compiled,  or  prepared  for 
assembly  as  an  input  file  for  LOWTRAN7.  This  is  accomplished  by  SENTRAN7’s 
Compile  Module.  The  SENTRAN7  compiler  performs  four  distinct  functions: 

1.  It  generates  LOWTRAN7  input  files  by  interpreting  edited  input  according 
to  a  special  data  generation  syntax 

2.  It  provides  a  list  of  active  molecular  absorbers  within  the  spectral  region  of 
the  LOWTRAN7  calculation 

3.  It  automatically  generates  a  methodology  file  with  the  same  first  name  as 
the  input  file  generated  (example:  typing  the  command  ‘compile  example* 
produces  two  files,  EXAMPLE.INP  and  EXAMPLE.MTH,  as  a  LOWTRAN7 
input  file  and  methodology  file,  respectively) 

4.  It  optionally  generates  a  special  debug  file  called  SEN.ERR. 


4.2.4. 1  Invoking  the  Compile  Module 

Like  most  of  SENTRAN7’s  main  functions,  the  SENTRAN7  compiler  is  in¬ 
voked  from  the  Main  Menu,  either  by  typing  ‘3’,  or  any  sub-string  of  the  word 
‘compile’,  such  as  ‘c\  The  user  has  the  option  of  imbedding  compiler  arguments 
O'.e.,  the  input  file  name  and  compiler  options)  within  the  initial  command  string,  or 
of  being  prompted  for  them  on  a  step-by-step  basis.  Table  10  shows  the  allowable 
compiler  commands  as  typed  from  the  Main  Menu  and  Table  1 1  gives  examples 
of  compiler  commands  and  their  effect. 

Table  10.  Allowable  Compiler  Commands  As  Typed  From  the  Main  Menu 


compile  [input  file  name ]  [/MESH  /NOMESH  /ERROR] 

or 

3  [carriage  return]  [input  file  name ]  [/MESH  /NOMESH  /ERROR] 


/MESH  Generates  All  Possible  Combinations  of  Perturbed  Input  Parameters 

/NOMESH  Perturbs  One  Parameter  at  a  Time,  Holding  All  Others  Fixed 

/ERROR  Creates  SEN.ERR  Containing  Compile  Errors  and  List  of  Active  Molecular  Absorbers 
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Table  11.  Examples  of  Compiler  Commands  as  Typed  From  the  Main  Menu 


COMMAND 

EFFECT 

compile  test  /m  /e 

Compiles  input  file  named  TESTJNP  as  MESH  and  generates 
the  error  file  SEN.ERR 

3  < RETURN > 

Compiles  input  file  named  TESTJNP  as  NOMESH  with  no 

test  In 

error  file 

com  test. wow 

Compiles  input  file  named  TEST. WOW  using  last  mode 
(MESH  or  NOMESH)  as  default,  no  error  file  generated 

c  test.dumb  /m  In  /e 

Compiles  input  file  named  TEST.DUMB  as  NOMESH, 
demonstrating  that  MESH  and  NOMESH  are  exclusive, 
with  NOMESH  taking  precedence.  An  error  file 
is  created 

4.2.4.2  MESH  and  NOMESH  Compiler  Options 

SENTRAN7’s  compiler  supports  two  options  which  control  how  many  separate 
LOWTRAN7  runs  are  created  in  the  input  file.  These  are  the  MESH  and  NOMESH 
options.  To  include  the  MESH  option,  the  user  enters  ‘/mesh’,  or  simply  ‘/m\  after 
the  name  of  the  input  file  to  be  created  by  the  SENTRAN7  compiler.  Similarly,  to 
include  the  NOMESH  option,  the  user  enters  ‘/nomesh’,  or  simply  7n\  after  the 
input  file  name.  Note  that  the  MESH  and  NOMESH  options  are  exclusive,  that  is, 
only  one  can  be  used  for  compiling  an  input  file.  If  both  options  are  specified,  the 
NOMESH  option  takes  precedence  and  the  input  file  will  be  compiled  as  NOMESH. 
Another  fact  worth  noting  is  that  the  SENTRAN7  compiler  “remembers”  the  last 
compilation  mode  selected  and  utilizes  this  as  the  default  mode  for  subsequent 
compilation  if  neither  the  MESH  or  NOMESH  options  are  specified. 

The  MESH  option  generates  all  possible  combinations  of  all  perturbed  input 
parameters  while  the  NOMESH  option  perturbs  one  parameter  at  a  time,  holding 
all  other  parameters  fixed  at  their  nominal  values.  The  difference  between  the 
MESH  and  NOMESH  options  can  be  demonstrated  in  Table  12  which  shows  the 
combinations  of  LOWTRAN7  runs  that  will  be  generated  by  SENTRAN7  when 
two  parameters  are  simultaneously  perturbed.  In  this  example,  both  parameters 
are  given  a  nominal  value  and  three  perturbation  values.  A  ‘M/N’  means  both  the 
MESH  and  NOMESH  options  generate  this  combination  for  a  LOWTRAN7  run. 
An  ‘M’  means  only  the  MESH  option  will  compile  this  combination.  The  MESH 
option  is  most  useful  for  studying  synergistic  effects  arising  from  the  simultaneous 
perturbation  of  several  parameters,  while  the  NOMESH  option  generates  a  smaller 
data  set  if  more  than  one  parameter  is  perturbed.  If  only  one  parameter  is  perturbed. 
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Table  12.  An  Example  of  Combinations  of  LOWTRAN7  Runs  for  the  MESH 
and  NOMESH  Compiler  Options  When  Two  Parameters  Are  Perturbed.  In  this 
example,  both  parameters  have  a  nominal  value  and  three  perturbations 


FIRST 

PARAMETER 

SECOND  PARAMETER 

Nominal  Value 

Perturbation  1 

Perturbation  2 

Perturbation  3 

Nominal  Value 

M/N1 

M/N 

M/N 

M/N 

Perturbation  I 

M/N 

M2 

M 

M 

Perturbation  2 

M/N 

M 

M 

M 

Perturbation  3 

M/N 

M 

M 

M 

1  ’M/N’  indicates  both  the  MESH  and  NOMESH  options  generate  this  LOWTRAN7  run 

2  ’M’  indicates  the  MESH  option  only  will  generate  this  LOWTRAN7  nin 

or  no  parameters  are  perturbed,  the  MESH  and  NOMESH  options  are  equivalent. 

SENTRAN7  places  few  restrictions  on  the  number  of  parameters  that  may  be 
perturbed,  although  the  compiler  insures  that  perturbed  values  for  a  particular  pa¬ 
rameter  are  physically  meaningful.  Up  to  10  simultaneous  perturbations  may  be 
realized  for  each  compilation,  with  each  perturbation  assuming  as  many  as  100 
distinct  values  (more  than  100  distinct  values  can  be  generated  for  each  variable  in 
NOMESH  form).  This  feature  permits  extremely  rapid  exploration  of  the  sensitivity 
of  different  LOWTRAN7  parameters,  with  the  unfortunate  side  effect  of  generating 
enormous  quantities  of  output.  In  fact,  SENTRAN7’s  capability  to  generate  multi¬ 
ple  runs  of  LOWTRAN7  far  outweigh  its  analysis  capabilities,  since  SENTRAN7 
can  only  graph  and  analyze  the  effects  of  two  simultaneous  perturbations  at  a  time. 

4.2.4.3  Error  File  Option 

Another  option  supported  by  SENTRAN7’s  compiler  is  the  ability  to  write 
SENTRAN7  compiler  error  messages  and  information  on  major  absorbers  within 
the  current  spectral  interval  to  a  special  file.  This  is  the  ERROR  option  in  the 
SENTRAN7  Compiler  Module.  To  include  the  ERROR  option,  the  user  enters 
‘/error’,  or  simply  ‘/e’,  after  the  name  of  the  input  file  to  be  created  by  the 
SENTRAN7  compiler.  The  ERROR  option  can  be  used  in  combination  with  the 
MESH  or  NOMESH  options,  or  alone. 

Selection  of  the  ERROR  option  causes  a  list  of  active  absorbers  and  their  spec¬ 
tral  range  of  activity  to  be  written  to  a  file  called  SEN.ERR ,  along  with  any  compile 
time  errors.  As  mentioned  previously,  the  SENTRAN7  Compiler  Module  checks 
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that  the  perturbed  values  of  each  parameter  are  within  range  for  that  particular 
parameter.  If  there  are  vab  •  that  are  not  within  range,  the  Compiler  Module 
will  issue  a  warning  to  the  user  on  the  screen  indicating  the  parameter  and  the 
value  out  of  range.  These  error  messages  can  also  be  written  to  the  file,  SEN. ERR, 
by  indicating  the  ‘/error’  option  when  entering  the  input  file  name  and  compiler 
options.  Thus,  the  ERROR  option  serves  as  a  crude  analysis  tool,  as  well  as  a 
potentially  useful  debugging  aid. 

4.2.5  Select  Module 

The  Main  Menu  Select  Module  is  a  new  feature  in  SENTRAN7  which  allows 
the  user  to  specify  which  transmission  model  to  be  used  in  their  sensitivity  anal¬ 
yses.  The  user  can  select  from  LOWTRAN7,  MODTRAN,  or  MODTRAN  run 
as  LOWTRAN7.  SENTRAN7  methodology  files  will  work  with  any  of  these  op¬ 
tions.  In  order  to  enter  the  Select  Module  the  user  types  ‘4’  or  ‘select’  at  the 
Main  Menu  command  line.  A  submenu  will  appear,  as  shown  in  Figure  11,  for 
choosing  which  model  to  run.  Enter  ‘1’,  ‘2’  or  ‘3’  in  order  to  run  LOWTRAN7, 
MODTRAN  or  MODTRAN  AS  LOWTRAN7,  respectively.  Note  that  this  option 
does  not  actually  execute  the  model  code,  but  instead  simply  chooses  which  model 
will  be  executed  from  the  Run  Module  (see  Section  4.2.6).  After  a  selection  is 
made,  SENTRAN7  internally  confirms  that  the  specified  executable  code  exists.  To 
do  this,  SENTRAN7  checks  the  configuration  file,  DIRECT.ORY,  which  contains 
the  directory  and  names  of  the  LOWTRAN7  and  MODTRAN  executable  codes, 
as  well  as  the  location  of  MODTRAN ’s  molecular  absorption  data  file  called  UF- 
TAPE.DAT.  (Refer  to  Section  3.4  for  more  information  about  the  DIRECT.ORY 
file.)  SENTRAN7  warns  the  user  if  the  executable  file  cannot  be  found.  The  user 
must  then  exit  SENTRAN7  and  edit  the  file  DIRECT.ORY  to  correctly  indicate 
where  the  transmission  model  executable  file  is  located.  If  DIRECT.ORY  does  not 
exist,  SENTRAN7  searches  the  current  directory  for  the  appropriate  files.  Once  a 
model  code  has  been  correctly  selected,  SENTRAN7  returns  to  the  Main  Menu. 

4.2.6  Run  Module 

The  Run  Module,  a  new  feature  in  SENTRAN7,  executes  the  transmission 
model  as  specified  in  the  Select  Module.  The  default  calculations  are  performed 
using  the  most  recent  input  file  to  be  compiled,  although  users  can  specify  any 
input  file  upon  entering  the  Run  Module.  The  Run  Module  produces  the  standard 
LOWTRAN7  output  files  named  tape7  and  tape8  which  can  then  be  interrogated 
in  the  Graph  and  Analyze  Module. 

To  select  the  Run  Module,  the  user  simply  types  in  ‘5’  or  ‘run’  at  the  main 
command  line  prompt.  SENTRAN7  will  then  prompt  the  user  for  the  input  file  to 
use,  with  the  default  being  the  last  input  file  compiled.  To  return  to  the  Main  Menu, 
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Figure  11.  SENTRAN7  Screen  Displaying  the  Choices  of  Model  Programs  to 
Execute 

without  executing  LOWTRAN7  or  MODTRAN,  type  in  ‘piT  for  “page  up”  at  the 
prompt  for  an  input  file  name.  This  will  return  the  user  to  the  Main  Menu.  To 
accept  the  default  input  file  name,  the  user  simply  hits  RETURN.  To  enter  a  new 
input  file,  type  in  the  new  file  name  and  then  hit  RETURN.  A  default  extension 
of  .JNP  is  appended  to  the  file  name  if  no  extension  is  given.  Once  the  user  has 
chosen  an  input  file,  SENTRAN7  will  execute  the  selected  model  code  and  ask  the 
user  to  please  wait  until  execution  is  completed.  The  time  required  to  complete  a 
run  will  depend  on  many  factors,  such  as  the  speed  of  the  host  computer  and  the 
type  of  calculation.  Once  the  calculations  are  completed,  the  user  hits  RETURN 
to  continue  and  is  returned  to  the  Main  Menu. 

4.2.7  Graph  and  Analyze  Module 

The  Graph  and  Analyze  (G&A)  Module  in  SENTRAN7  provides  the  user  with 
a  powerful  tool  for  analyzing  results  from  a  LOWTRAN7  simulation.  The  options 
available  with  the  G&A  Module  allow  the  user  to  display  and  manipulate  the  output 
from  a  given  simulation.  In  particular,  the  G&A  Module  provides: 

1.  Flexible  options  for  extracting  and  displaying  output  from  LOWTRAN7 
calculations  and  various  input  files. 

2.  Tools  for  data  manipulation,  analysis,  and  archiving. 

3.  Commands  for  generating  graphical  plots  of  data  and  special  graphics  files 
for  archival,  hard  copy,  and  exporting  to  commercial  graphics  and  analysis 
packages. 
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4.2.7.1  Types  of  Plots  Available 

A  SENTRAN7  plot  of  results  from  a  LOWTRAN7  calculation  consists  of  a  de¬ 
pendent  parameter  (such  as  transmittance,  radiance,  differential  transmittance,  etc.) 
in  terms  of  one  or  two  independent  parameters.  The  dependent  parameter  is  always 
the  z  axis.  Table  13  lists  the  type  of  plots  available  from  the  G&A  Module  and 
the  specific  choices  for  the  z  axis.  As  will  be  discussed  further  in  Section  4.2.7.4, 
SENTRAN7  imposes  restrictions  on  the  choices  of  the  x  and  y  axes  among  the  two 
independent  variables.  For  this  reason,  the  user  is  urged  to  note  that  SENTRAN7’s 
G&A  Module  is  intended  to  represent  a  tool  for  use  in  analyzing  results  from  a 
LOWTRAN7  simulation,  but  is  not  intended  as  the  only  tool  to  use. 

4.2.7.2  Invoking  the  Graph  and  Analyze  Module 

The  Graph  and  Analyze  Module  extracts  its  data  from  LOWTRAN7’s  output 
files  based  on  the  current  information  specified  in  the  Edit  Module.  Therefore, 
users  are  encouraged  to  use  the  Graph  and  Analyze  Module  immediately  after 
running  LOWTRAN7,  and  avoid  changing  any  parameters  in  the  Edit  Module. 

To  enter  the  G&A  Module,  the  user  types  ‘6’  or  'graph’,  or  any  sub-string  of 
the  word  ‘graph’,  such  as  ‘g\  at  the  Main  Menu  prompt.  The  initial  G&A  screen 
will  then  appear.  An  example  of  this  screen  is  shown  in  Figure  12. 
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Figure  12.  Example  of  an  Initial  Screen  in  the  Graph  and  Analyze  Module 
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Table  13.  Type  of  Plots  Available  in  the  SENTRAN7  Graph  and  Analyze  Module 


_ PLOT  TYPE _ z  AXIS  PARAMETER  CHOICES 

Raw  x,  y,  2  None  needed 

Transmittance  Total  Transmittance 

Log  of  Total  Transmittance 
Uniform  Mixed  Gases 
Trace  Gases 
Molecular  Scattering 
H20 

H20  Continuum 
Ozone  (O3) 

N2  Continuum 

Aerosol  and  Hydrometeor 

C02 

CO 

CH4 

NoO 

O2 

NHj 

NO 

no2 

so2 

hno3 

Aerosol  and  Hydrometeor  Absorption 

Atmospheric  Radiance  Total  Transmittance 

Radiance 

Log  of  Total  Transmittance 

Differential  lYansmittance  DTAU 

DTAU  /  Layer  Thickness 

Black  Body  Function  DTAU  *  Black  Body  Function 

(DTAU  *  Black  Body  Function)  / 

Layer  Thickness 

Fluxes/Irradiance  Upward  Total  FLUX 

Upward  Solar  FLUX 
Downward  Total  FLUX 
Downward  Solar  FLUX 

_ Direct  Solar  Irradiance _ 

Solar/Lunar  Radiance  Total  Transmittance 

Radiance 

Path  Scattered 

Single  Scattered 

Total  Ground  Reflectance 

Direct  Reflected 

Total  Radiance 

Log  of  Total  Transmittance 

Direct  Solar  Radiance  Total  Transmittance 

Transmitted  Solar 

Incident  Solar 

Log  of  Total  Transmittance 


4.2.7.3  Specifying  the  Plotting  Parameters 

Upon  entry  into  the  G&A  Module,  the  user  will  be  prompted  for  a  number  of 
options  regarding  the  sources  of  data  to  be  plotted.  These  selections  control  how 
SENTRAN7  extracts  data  from  various  sources,  although  from  the  user’s  point  of 
view  the  choices  will  appear  to  relate  to  the  selection  of  two  independent  axes  (x 
and  y )  and  one  dependent  axis  (z). 

For  all  plot  types,  the  user  is  prompted  for  the  output  file  in  which  to  find  the 
data.  For  all  cases  except  when  plotting  a  raw  x .  y ,  z  data  file,  SENTRAN7  will 
provide  a  default  file  name  (TAPE7.0UT  or  TAPE8.0UT).  The  default  file  name 
given  corresponds  to  the  last  LOWTRAN7  or  MODTRAN  output  file  produced. 
Whether  the  default  file  name  is  TAPE? .OUT  or  TAPE8.0UT  will  depend  on  the  z 
axis  parameter  chosen  to  plot.  To  accept  the  default  file  name,  should  simply  hit 
RETURN.  To  plot  data  from  a  previous  LOWTRAN7  or  MODTRAN  run,  enter 
the  output  file  name  and  then  hit  RETURN. 

4.2.7.4  Restrictions  Imposed  by  the  Graph  and  Analyze  Module 

When  selecting  the  plotting  parameters,  the  Graph  and  Analyze  Module  of 
SENTRAN7  imposes  some  restrictions  on  the  choices  available.  For  example,  if 
the  user  selects  the  differential  transmittance  plot  type,  DTAU,  the  G&A  Mod¬ 
ule  automatically  sets  the  x  axis  to  atmospheric  layer  number  and  the  y  axis  to 
wavenumber  or  wavelength.  These  axes  choices  are  “hardwired”  into  the  code  and 
cannot  be  changed  by  the  user.  Other  graphing  restrictions  are  imposed  based  on 
the  number  of  parameters  being  perturbed  and  the  choice  of  MESH  or  NOMESH 
options.  Appendix  D  contains  a  more  detailed  description  of  the  logic  flow  of  the 
plotting  options  and  how  and  when  these  restrictions  are  established. 

It  is  recognized  that  these  restrictions  may  be  frustrating  to  the  user  and  may 
represent  choices  the  user  did  not  want  to  make.  These  restrictions  were  established 
in  the  original  version  of  SENTRAN  developed  for  LOWTRAN6  and  resources 
were  not  available  to  change  them  under  this  effort.  It  is  hoped  that  in  future 
revisions  to  SENTRAN7  these  restrictions  can  be  lessened  or  eliminated. 

4.2.7.5  Commands  Available  With  the  Graph  and  Analyze  Module 

Once  the  user  has  responded  to  the  questions  regarding  data  sources,  the  G&A 
Module  enters  a  special  loop  that  interprets  single  line  commands  and  immediately 
executes  them  in  order  to  manipulate  and  plot  the  data  set.  Commands  are  always 
issued  from  a  text  screen  known  as  the  command  screen,  while  plots  are  displayed 
on  a  special  graphics  screen.  Figure  13  shows  a  typical  G&A  command  screen  and 
Figure  14  shows  a  representative  3-D  plot.  Note  that  commands  need  not  be  typed 
in  their  entirety,  provided  the  shortened  command  matches  the  first  several  letters 
of  the  desired  command  and  does  not  match  any  other  command.  The  commands  in 
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the  G&A  Module  can  be  divided  into  three  main  groups:  1)  numerical  commands, 
2)  plotting  commands,  and  3)  I/O  and  control  commands. 
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Figure  13.  An  Example  of  a  Command  Screen  from  the  SENTRAN7  Graph  and 
Analyze  Module 

The  numerical  commands  perform  common  arithmetic  manipulations  on  the 
data  set.  Table  14  lists  all  of  the  numerical  commands  that  enable  the  user  to 
analyze  and  manipulate  the  data.  These  commands  permit  numerical  differentiation 
and  common  numerical  conversions  to  be  carried  out.  When  a  numerical  operation 
or  conversion  is  applied  to  an  axis,  the  axis’  label  is  modified  accordingly.  For 
example,  if  the  z  axis  label  is  “TRANSMITTANCE”,  and  the  user  performs  a  log 
conversion  on  the  z  axis,  then  the  z  axis  label  will  be  “LOG  TRANSMITTANCE”. 
This  change  is  reflected  both  on  the  plots  and  on  the  command  screen. 

The  plotting  commands  provide  the  user  with  a  means  to  control  certain  aspects 
of  the  graphical  presentation  of  the  data  set.  Table  15  lists  the  plotting  commands 
available  in  the  G&A  Module  of  SENTRAN7.  The  main  plotting  command  is  the 
PLOT  command.  The  PLOT  command  initiates  plotting  of  the  data  set.  The  user 
must  provide  an  argument  consisting  of  a  file  name  to  which  graphics  data  will  be 
written  and/or  the  reserved  argument  ‘  VT240’,  which  will  cause  the  plot  to  be  sent 
to  the  terminal  screen.  The  plot  file  is  automatically  given  a  .TEK  extension  if  no 
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Figure  14.  An  Example  of  a  3-D  Plot  from  the  SENTRAN7  Graph  and  Analyze 
Module 

extension  is  supplied  by  the  user.  Note  that  the  user  can  specify  both  a  file  name 
and  the  reserved  argument  ‘VT240’  in  order  to  have  the  graph  written  to  both  a 
file  and  the  screen.  If  the  graph  is  a  3-D  plot,  the  user  will  also  be  prompted  for 
rotation  angles  for  the  axes.  The  user  may  enter  these  values  in  free  format  or 
press  the  RETURN  key  to  accept  the  values  which  are  currently  displayed  in  the 
field.  The  first  angle  is  a  counterclockwise  rotation  about  the  original  z  axis,  while 
the  second  angle  is  a  counterclockwise  rotation  about  the  x  axis  ( i.e .,  tilt  out  of  the 
screen).  (Note  that  these  rotation  angles  are  often  adjusted  slightly  by  the  G&A 
Module  before  plotting.)  After  entering  these  parameters,  the  G&A  Module  will 
plot  the  data,  either  to  the  file  specified,  the  screen  or  both.  If  the  plot  is  to  the 
screen,  hitting  RETURN  will  return  the  user  to  the  command  screen. 

The  other  commands  shown  in  Table  15  provide  a  means  for  controlling  the 
graphical  presentation  of  the  data.  These  commands  include  the  TITLE  command 
for  placing  a  title  at  the  top  of  the  graph,  and  labeling  commands  for  the  x,  y  and 
z  axes:  XLABEL,  YLABEL  and  ZLABEL,  respectively.  With  all  four  of  these 
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Table  14.  List  of  Numerical  Commands  in  the  SENTRAN7  Graph  and  Analyze 
Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

A2T 

NONE 

Optical  Depth  to  Transmittance  Transformation 
Transform  z  axis  according  to  z=exp(-z) 

DX 

NONE 

Compute  partial  derivative  of  the  data  set 
with  respect  to  the  x  axis 

DY 

NONE 

Compute  partial  derivative  of  the  data  set 
with  respect  to  the  y  axis 

DDX 

NONE 

Compute  second  partial  derivative  of  the  data  set 
with  respect  to  the  x  axis 

DDY 

NONE 

Compute  second  partial  derivative  of  the  data  set 
with  respect  to  the  y  axis 

DYDX 

NONE 

Compute  cross  derivative  of  the  data  set 
with  respect  to  the  y  axis  and  then  the  x  axis 

DXDY 

NONE 

Compute  cross  derivative  of  the  data  set 
with  respect  to  the  x  axis  and  then  the  y  axis 

LOG 

IX][Y]{Z] 

Transform  all  coordinates  of  the  named  axis 
to  their  log  values  (Example:  ‘log  x’) 

MAXIMUM 

NONE 

Write  the  maximal  z  values  on  the  screen  along 
with  their  x,y  coordinates 

MEAN 

NONE 

Compute  and  displays  the  mean  z  axis  value 

MINIMUM 

NONE 

Write  the  minimal  z  values  on  the  screen  along 
with  their  x,y  coordinates 

NOSORT 

[X][Y] 

Suppress  SENTRAN’s  tendency  to  son  data  into 
increasing  order  (Example:  ‘nosort  x’) 

SWAP 

NONE 

Swap  the  x  and  y  axes 

T2A 

NONE 

Transmittance  to  Optical  Depth  Transformation 
Transform  z  axis  according  to  z=log(l/z) 

commands,  the  text  entered  by  the  user  following  the  command  is  treated  as  the 
title  or  axis  label,  respectively. 

Table  16  lists  the  I/O  and  control  commands  of  the  G&A  Module.  There 
are  currently  five  general  control  commands:  WRITE,  COSMETIC,  NEW,  EXIT, 
HELP  and  REFRESH. 

In  order  to  conveniently  store  the  x,  y,  and  z  data  currently  being  plotted, 
SENTRAN7  provides  a  WRITE  command  in  the  G&A  Module  for  writing  the 
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Table  15.  List  of  Plotting  Commands  in  the  SENTRAN7  Graph  and  Analyze 
Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

PLOT 

[file  namel(VT240] 

Plot  the  data  set  to  the  specified  file  name 
( *.TEK)  or  to  the  screen  [VT240  argument] 
(NOTE:  Both  arguments  may  be  specified  and 
the  program  will  plot  the  data  to  the  file 
and  to  the  screen) 

TITLE 

[plot  title] 

Treat  all  following  text  as  title  for  next  plot, 
and  center  this  text  at  the  top  of  the  plot 

XLABEL 

[x  axis  Label] 

Treat  all  following  text  as  the  x  axis  label 
(up  to  30  characters) 

YLABEL 

[y  axis  Label] 

Treat  all  following  text  as  the  y  axis  label 
(up  to  30  characters) 

ZLABEL 

[z  axis  Label] 

Treat  all  following  text  as  the  z  axis  label 
(up  to  30  characters) 

Table  16.  List  of  I/O  and  Control  Commands  in  the  SENTRAN7  Graph  and 
Analyze  Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

WRITE 

[x,y,z  file  name] 

Write  the  current  data  set  to  the  named 
file  as  raw  x,  y,  z  data 
(default  extension  is  3D) 

COSMETIC 

[file  name] 

Screendump  of  current  G&A  command  screen 
to  the  named  file 

NEW 

NONE 

Restart  the  G&A  Module 

EXIT 

NONE 

Exit  the  G&A  Module,  return  to  Main  Menu 

HELP 

[command  name] 

Accesses  the  G&A  on-line  help  utility. 

If  a  valid  G&A  command  is  supplied  as  an 
argument,  then  help  on  the  selected  command 
is  provided.  If  no  argument  is  supplied, 
then  a  special  introductory  HELP  screen  is 
presented,  listing  all  of  the  G&A  commands. 

REFRESH 

NONE 

Redraw  the  G&A  command  screen 
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data  to  a  file.  The  user  simply  types  ‘write  filename ’  at  the  command  line  prompt 
and  the  current  x ,  y,  and  z  data  are  written  in  three  columns  to  that  file.  No 
header  information  is  stored  in  the  file.  The  filename  is  automatically  given  a  3D 
extension  if  none  is  specified.  For  example,  if  the  user  enters  ‘write  test’,  the 
data  are  written  to  the  file  TEST  3D.  If  the  user  enters  ‘write  test.dat’,  the  data 
are  stored  to  the  file  TEST.DAT.  These  files  can  be  used  to  save  specific  results 
the  user  is  interested  in,  rather  then  saving  the  sometimes  large  tape7  and  tape8 
files  that  LOWTRAN7  and  MODTRAN  can  produce.  They  can  easily  be  plotted 
again  at  a  later  time  by  choosing  the  raw  x,  y,  z  plot  type  in  the  G&A  Module.  In 
addition,  these  data  files  can  easily  be  used  by  other  commercial  graphics  programs 
to  create  more  detailed  plots. 

The  COSMETIC  command  of  the  G&A  Module  provides  a  quick  method  for 
storing  what  data  has  been  plotted  or  written  to  a  raw  x.  y,  z  file.  This  command, 
writes  a  screen  dump  of  the  G&A  command  screen  to  a  file  specified  by  the  user. 
A  default  extension  of  .COS  is  attached  to  the  filename  if  none  is  specified. 

In  order  to  restore  altered  data  or  to  select  an  alternative  data  set,  the  user  must 
restart  the  G&A  Module  by  using  the  NEW  command.  This  places  the  user  at  the 
initial  G&A  menu  for  choosing  the  plot  type.  The  user  will  need  to  specify  the 
plotting  parameters  again  before  resuming  command  mode.  The  NEW  command 
must  also  be  used  to  “refresh”  the  data  set  if,  for  example,  the  user  wants  to  look 
at  the  derivative  of  the  original  data,  after  having  already  taken  the  LOG  of  the 
data. 

If  for  some  reason  the  G&A  command  screen  becomes  corrupted  (by  a  system 
message  from  another  user,  for  example),  the  user  can  enter  the  REFRESH  com¬ 
mand  to  restore  the  G&A  screen.  This  command  simply  redraws  the  command 
screen. 

The  HELP  command  accesses  the  G&A  on-line  help  utility.  This  command 
is  especially  useful  for  recalling  what  commands  are  available  within  the  G&A 
Module  of  SENTRAN7,  and  also  what  each  of  these  commands  do.  If  the  user 
enters  ‘help’  with  no  argument  supplied,  a  special  introductory  help  screen  is  pre¬ 
sented,  listing  all  the  available  G&A  commands.  The  user  can  also  obtain  specific 
information  about  each  of  these  commands  by  entering  ‘help  command ’,  where 
command  is  the  command  name  the  user  needs  a  description  of.  For  example,  to 
obtain  information  about  the  PLOT  command,  the  user  enters  ‘help  plot’  at  the 
command  line.  A  help  screen  containing  a  description  of  the  PLOT  command  will 
appear  as  shown  in  Figure  15.  The  user  hits  RETURN  or  ENTER  to  return  to  the 
G&A  module  command  screen. 
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Figure  15.  An  Example  of  an  On-Line  Help  Screen  Within  Graph  and  Analyze 
Module  of  SENTRAN7.  (Note  that  the  help  screen  does  not  appear  as  a  partial 
overlay  during  execution  as  shown  in  this  figure,  but  rather  covers  the  entire  screen.) 

4.2.8  Plotting  Trace  Gas  Input  Profiles 

A  new  feature  of  SENTRAN7  is  the  ability  to  plot  trace  gas  profiles  and  their 
perturbations.  This  option  has  been  implemented  in  a  two-step  process.  The  user 
first  stores  the  trace  gas  profile,  and  its  perturbation  values,  if  any,  by  typing  the 
command  ‘write’  when  editing  the  particular  molecular  species  on  the  LOWTRAN 
input  card  Card  2C.  Second,  the  user  plots  these  data  from  within  the  G&A  Module 
of  SENTRAN7  by  choosing  the  option  to  plot  a  raw  x,  y,  z  data  file  and  entering 
the  filename  created  within  the  Edit  Module. 

When  the  user  types  ‘write’  while  editing  Card  2C,  the  input  profile  data  for 
the  molecular  species  the  user  is  currently  editing  is  written  to  a  raw  data  file. 
If  the  molecular  species  has  been  perturbed  by  the  user,  the  perturbation  values 


are  also  written  to  the  data  file.  The  data  files  are  automatically  named  by  the 
program  with  the  first  part  of  the  filename  being  set  to  the  parameter  name  (i.e., 
P,  T,  03,  etc.),  with  the  default  extension  .3D  added.  The  data  file  consists  of  five 
columns.  The  first  column  consists  of  the  data  values  for  the  unperturbed  molecular 
species.  The  second  column,  which  represents  the  y  axis  data,  will  always  be  zero 
because  this  is  a  2D  plot.  The  third  column  contains  the  altitude  data  to  be  plotted 
on  the  z  axis.  The  fourth  and  fifth  columns  contain  the  minus  and  plus  percent 
perturbations,  respectively,  of  the  original  molecular  species  data  values.  If  no 
percent  perturbation  was  entered  by  the  user,  these  columns  are  set  to  —999.0. 

At  this  point,  it  must  be  mentioned  that  the  write  command  creates  a  .3D 
data  file  based  on  numerical  values  in  the  specified  .PRO  file,  but  it  does  not 
consider  the  values  of  JCHAR.  This  is  an  important  footnote  to  remember  because 
L0WTRAN7  uses  model  atmosphere  amounts  for  layers  where  JCHAR  is  set  to  1- 
6,  even  if  numerical  values  are  specified.  For  these  scenarios,  the  trace  gas  profiles 
plotted  by  SENTRAN7  do  not  represent  the  actual  profiles  used  by  L0WTRAN7. 
Future  versions  of  SENTRAN7  will  hopefully  address  this  dilemma. 

Figures  16-20  provide  the  user  with  a  specific  example  of  how  to  perturb  a 
parameter  on  the  LOWTRAN  input  Card  2C  and  write  the  input  profile  of  this 
parameter,  along  with  its  perturbation  values,  to  a  file.  This  example  perturbs  the 
O3  parameter  on  Card  2C  by  20%  and  writes  the  input  profile  to  the  default  file, 
03. 3D.  In  this  example,  it  is  assumed  that  the  user  is  editing  the  LOWTRAN  input 
Card  2C  and  presses  RETURN  until  the  cursor  is  positioned  on  the  line  containing 
the  03  parameter.  The  user  then  enters  ‘%20’  for  the  perturbation  value  for  the  O3 
parameter,  as  shown  in  Figure  16,  and  hits  RETURN.  The  cursor  is  now  located 
on  the  N2O  parameter  on  Card  2C.  To  move  the  cursor  back  to  the  O3  parameter, 
the  user  enters  the  ‘up’  command,  as  shown  in  Figure  17.  The  ‘up’  command 
moves  the  cursor  back  to  the  line  containing  the  O3  parameter.  The  user  then 
types  in  ‘write’  while  on  the  line  containing  the  O3  parameter  in  order  to  write 
the  O3  input  profile  and  its  perturbation  values  to  the  file  03.3D.  This  is  shown 
in  Figure  18.  Once  the  file  has  been  written,  the  name  of  the  file  is  displayed  in 
the  lower  right  hand  comer  of  the  screen,  as  shown  in  Figure  19.  The  contents  of 
the  file  03. 3D  are  shown  in  Figure  20.  Recall  that  the  first  column  is  the  original 
O3  input  profile  and  the  third  column  is  the  altitude.  The  fourth  column  is  a  -20% 
perturbation  and  the  fifth  column  is  a  +20%  perturbation  of  the  first  column. 

Note  that  the  above  example  was  a  specific  example  involving  the  O3  parameter 
on  the  LOWTRAN  Card  2C.  The  user  can  perturb  any  of  the  parameters  on  Card  2C 
and  write  that  parameter’s  input  profile  and  perturbation  values  to  a  file,  using  a 
similar  method.  Also  note  that  it  is  not  necessary  to  perturb  the  input  profile  before 
writing  that  profile  to  an  output  file.  If  the  user  wishes  to  write  the  input  profile 
of  a  parameter  on  Card  2C  to  a  file,  without  perturbing  that  parameter,  the  user 
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Figure  16.  An  Example  of  the  Command  Used  to  Perturb  the  O3  Input  Profile  on 
the  LOWTRAN  Input  Card  2 C  by  20% 

need  simply  enter  the  ‘write’  command  when  the  cursor  is  located  at  the  desired 
parameter,  without  entering  a  percent  perturbation. 

Once  the  input  profiles  on  Card  2C  have  been  written  to  an  output  file,  they 
can  be  plotted  within  the  G&A  Module  by  choosing  the  raw  x,  y,  z  plot  type  and 
entering  the  output  filename  ( *.3D )  saved  within  the  Edit  Module.  The  graphical 
output  of  the  O3  input  profile  saved  in  the  example  above,  is  shown  in  Figure  21. 
The  O3  input  profile  is  plotted  along  with  ±20%  perturbations.  This  plot  is  created 
by  choosing  the  raw  x,y,z  plot  type  within  the  G&A  Module  and  entering  the 
filename  03. 3D.  The  user  must  label  the  axes  by  using  the  XLABEL  and  ZLABEL 
commands  before  plotting  the  data.  The  LOG  command  within  the  G&A  Module 
can  also  be  used  on  the  input  profile  plots.  However,  the  derivative  commands  are 
not  available  when  plotting  trace  gas  input  profiles. 

4.2.9  Miscellaneous 

There  are  three  simple  commands  accessible  from  the  Main  Menu,  which  are 
not  displayed  as  Main  Menu  choices.  These  are  the  LOG,  NOPROMPT,  and  ZAP 
commands. 

The  LOG  command  turns  on  SENTRAN7’s  logging  capability.  When  this 
command  is  entered,  SENTRAN7  will  proceed  to  write  all  user  input  to  a  file 
named  SEN. LOG.  SENTRAN7  automatically  adds  comments  to  this  file  that  help 
the  user  to  determine  the  logical  flow  taken  through  SENTRAN7,  aiding  the  user 
in  interactive  development  and  the  debugging  of  files  for  batch  made  submission. 
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Figure  17.  Example  of  the  Command  to  Move  the  Cursor  Up  One  Line  to  the  O3 
Parameter  on  the  LOWTRAN  Input  Card  2C  Sequence 
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Figure  18.  Example  of  the  Command  to  Write  the  O3  Input  Profile  Specified  by 
the  LOWTRAN  Input  Card  2C  to  a  Data  File 
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Figure  19.  Example  of  the  Screen  Displayed  After  the  Perturbed  O3  Input  Profile 
Has  Been  Written  to  a  File 

The  user  may  replace  these  automatic  comments  with  comments  of  his  or  her  own 
when  entering  commands  into  SENTRAN7.  Comm;nts  consist  of  all  text  within 
the  input  string  following  an  apostrophe.  For  example,  in  the  string,  edit  ’invoke 
editor  function,  “invoke  editor  function”  is  a  comment  and  will  be  ignored  by  the 
program.  SENTRAN7  will  then  display  the  word  “LOG”  in  the  extreme  upper  left 
of  the  screen  when  the  LOG  feature  is  active. 

The  NOPROMPT  command  suppresses  all  writing  to  the  screen.  This  feature  is 
useful  for  batch  submissions  since  screen  output  is  unnecessary  in  such  situations. 
NOPROMPT  also  functions  as  a  toggle.  Therefore,  if  screen  output  is  inadvertently 
disabled,  it  may  be  re-enabled  by  typing  ’noprompt’  a  second  time. 

The  ZAP  command  resets  all  LOWTRAN7  variables  to  their  default  values  and 
eliminates  all  perturbation  directives.  (The  default  values  are  “hardwired”  into  the 
SENTRAN7  code  and  cannot  be  changed.)  The  ZAP  command  is  useful  when 
the  user  wishes  to  make  extensive  revisions  to  LOWTRAN7  input  cards;  revisions 
so  extensive  that  starting  from  the  default  values  of  the  LOWTRAN7  variables, 
with  no  perturbations,  is  simpler  than  editing  all  of  the  necessary  variables  and 
removing  perturbation  commands  that  have  already  been  entered  by  the  user. 
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Figure  20.  Sample  of  a  Trace  Gas  Input  Profile  Data  File  ( 03.3D )  as  Created 
Using  a  20%  Perturbation 
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Figure  21.  An  Example  of  a  2-D  Plot  of  an  O3  Input  Profile  with  ±  20%  Pertur 
bations  Assumed 
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5  SENTRAN7  TUTORIAL 

While  the  previous  chapters  provided  a  fairly  general  description  of  SEN- 
TRAN7  from  a  functional  point  of  view,  it  does  little  in  the  way  of  teaching 
the  user  how  to  actually  use  SENTRAN7.  This  chapter  will  guide  the  user  through 
a  series  of  brief  exercises  which  should  make  the  user  reasonably  comfortable  with 
using  SENTRAN7.  It  is  encouraged  that  the  user  actually  use  the  program  while 
proceeding  through  these  tutorials. 

5.1  Basic  Concepts  of  the  User  Interface 

One  of  the  chief  features  of  SENTRAN7  is  its  flexible  user  interface,  which 
permits  users  to  perform  the  exact  same  task  in  a  number  of  different  ways.  This 
allows  the  program  to  accommodate  differences  in  personal  preference  with  respect 
to  data  entry  and  makes  it  more  comfortable  for  users  who  have  differing  levels  of 
skill  in  using  the  program.  For  example,  novice  users  can  proceed  in  a  step-by-step 
manner,  providing  simple  responses  to  a  series  of  prompts,  while  advanced  users 
may  prefer  to  type  in  complete  command  strings,  bypassing  the  majority  of  input 
prompts.  This  command  parsing  feature  can  dramatically  reduce  the  time  required 
to  perform  routine  tasks.  The  following  tutorials  will  demonstrate  both  step-by-step 
and  command  driven  syntax.  Again,  we  stress  that  it  is  worth  the  time  investment 
required  to  use  the  software  while  learning  the  command  driven  syntax. 

5.2  Conventions  Used  in  the  l\itorials 

As  the  user  proceeds  through  the  following  tutorials,  please  keep  the  following 
conventions  in  mind: 

-  The  text  which  must  be  entered  will  appear  in  ‘boldface’,  and  single  quotes. 
Note  also  that  when  running  SENTRAN7  you  may  use  either  lower  or  upper 
case. 

-  You  must  press  the  RETURN  (or  ENTER)  key  after  every  command. 

-  Often,  the  only  input  required  will  be  the  pressing  of  the  RETURN  key 
(z'.e.,  when  accepting  a  default,  or  acknowledging  an  error  message).  There¬ 
fore  RETURN  means  “press  the  return  or  enter  key”.  Note  that  the  term 
“RETURN  key”  is  equivalent  to  “ENTER  key”  in  these  tutorials. 
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5.3  SENTRAN7  Tutorial  #1 


5.3.1  Getting  Started 

Begin  by  executing  the  SENTRAN7  executable  file  on  your  system.  The 
file  LAST.MTH  is  loaded  into  SENTRAN7  immediately  upon  execution,  provided 
that  it  exists,  and  provides  a  default  methodology.  A  methodology  file,  such  as 
LAST.MTH,  contains  images  of  LOWTRAN7  or  MODTRAN  input  parameters  (the 
standard  input  “cards”)  and  control  parameters  for  their  perturbation.  (When  run¬ 
ning  SENTRAN7,  the  most  recent  methodology  file  generated  is  always  copied 
into  a  special  file  named  LAST.MTH ,  which  as  mentioned  above  is  used  by  SEN- 
TRAN7  at  start-up.)  When  SENTRAN7  is  executed  for  the  first  time,  a  LAST.MTH 
methodology  file  may  not  yet  exist.  If  this  is  the  case  the  initial  screen  will  look 
like  Figure  22.  The  program  displays  an  error  message  in  reading  the  last  method¬ 
ology  file.  Don’t  panic!  The  program  will  continue  with  the  default  parameters  set 
within  the  software  code.  Once  you  hit  RETURN,  the  SENTRAN7  Main  Menu 
will  appear,  as  shown  in  Figure  23. 

5.3.2  Using  the  Load  and  Save  Module 

The  Load  and  Save  Module  permits  you  to  retrieve  and  store  LOWTRAN7 
input  parameters  and  directives  for  parameter  variation.  In  the  following  tutorial, 
we  will  load  one  of  the  methodology  files  that  is  supplied  with  the  distribution 
tape  named  DEFAULT .MTH ,  and  save  it  under  the  name  FLRST.MTH,  using  both 
step-by-step  and  command  driven  techniques. 

Step  1: 

Type  ‘1*  at  the  Main  Menu  shown  in  Figure  23  in  order  to  load  a  methodology 

file. 

Step  2: 

SENTRAN7  will  prompt  you  to  specify  if  you  want  to  load  or  save  a  method¬ 
ology  file,  as  shown  in  Figure  24.  In  response  to  this  prompt,  enter  ‘load’. 

The  program  will  then  display  a  list  of  all  the  files  in  the  current  directory  that 
have  the  extension  .MTH,  which  is  the  default  extension  for  methodology  files,  and 
will  prompt  you  for  the  file  name  to  load.  An  example  of  the  displayed  screen  is 
shown  in  Figure  25.  (Note  that  your  screen  may  not  look  exactly  like  this  example 
because  you  will  not  have  the  same  methodology  files  in  your  current  directory.) 

Step  3: 

In  response  to  the  prompt  for  a  methodology  file  name,  enter  ‘default’.  SEN- 

TRAN7  will  load  DEFAULT. MTH  and  return  to  the  Main  Menu. 
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Figure  22.  SENTRAN7  Screen  Displayed  When  the  LAST.MTH  Methodology  File 
is  not  Found  to  Exist 
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Figure  23.  The  Main  Menu  of  SENTRAN7 
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Figure  24.  Screen  Prompt  for  Specifying  Use  of  the  Load  or  Save  Options 
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Figure  25.  Example  of  the  SENTRAN7  Screen  Listing  the  Available  Methodology 
Files  to  Load  Into  SENTRAN7 
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Step  4: 

Now,  repeat  Step  1  and  type  ‘load  default’  at  Step  2.  Note  that  this  accom¬ 
plishes  the  same  task  as  Steps  1 ,  2  and  3  in  one  less  step. 

Step  5: 

At  the  Main  Menu  type  ‘load  default’.  Note  that  we  have  accomplished  the 
task  of  loading  DEFAULT .MTH  in  a  single  step! 

Now  that  we  have  loaded  DEFAULT  MTH,  its  contents  are  stored  in  the  appro¬ 
priate  parameters  in  the  Edit  Module.  The  following  steps  will  save  the  values  of 
the  parameters  in  the  Edit  Module,  to  a  file  named  FIRSTMTH. 

Step  6: 

Enter  ‘1’  at  the  Main  Menu  prompt  to  again  invoke  the  Load/Save  Module. 
Step  7: 

In  response  to  the  prompt  for  “LOAD  OR  SAVE  METHODOLOGY  FILE’,  as 
shown  in  Figure  24,  type  ‘save’.  SENTRAN7  will  prompt  you  for  the  name 
of  the  methodology  file  to  create. 

Step  8: 

In  response  to  the  prompt  for  a  methodology  file  name,  type  ‘first’.  SEN- 
TRAN7  will  then  create  a  new  methodology  file  named  FIRSTMTH  which  is 
identical  to  DEFAULT  MTH.  You  may  wish  to  verify  this  fact. 

Step  9: 

We  can  reduce  the  number  of  steps  required  to  save  FIRSTMTH  by  performing 
Step  6  and  typing  ‘save  first’  at  Step  7. 

Step  10: 

We  may  reduce  the  number  of  steps  further  by  entering  ‘save  first’  at  the  Main 
Menu  prompt.  This  will  accomplish  the  same  task  as  Steps  6,  7  and  8  in  a 
single  step. 

Since  we  have  just  generated  a  file  named  FIRSTMTH,  the  values  stored  in 
this  methodology  file  are  still  set  to  the  parameters  in  the  Edit  Module.  If  you 
have  not  performed  the  above  steps,  please  do  so  now,  since  it  is  important  that 
the  screens  which  SENTRAN7  presents  are  identical  to  those  in  this  tutorial.  Our 
next  goal  is  to  modify  FIRSTMTH  in  order  to  generate  the  following  test  case: 

Transmittance  for  horizontal  paths  with  various  optical  ranges  (I  to  10  km) 
at  several  altitudes  (0  to  20  km)  for  a  selected  wavenumber  of  1300  cm-1 
with  MODEL=6  and  IHAZE=I 
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We  will  accomplish  this  task  by  first  editing  the  necessary  input  cards  as  described 
in  the  following  section. 

5.3.3  Using  the  Edit  Module 

Before  we  begin,  it  is  important  to  remind  you  of  the  basic  methods  for  moving 
around  in  the  Edit  Module  of  SENTRAN7  and  what  to  do  if  you  make  a  mistake. 
If  you  enter  an  incorrect  value  at  a  line  or  inadvertently  skip  past  a  line,  don’t 
panic.  You  can  move  up  and  down  within  the  card  image  by  using  the  ‘up’  and 
‘dn’  commands.  For  example,  if  you  need  to  move  back  to  a  previous  parameter 
on  a  card,  type  ‘up’  and  the  number  of  lines  to  move  back,  and  press  RETURN. 
The  cursor  will  move  back  to  that  parameter,  provided  that  line  of  the  input  card 
is  editable.  Use  these  commands  then  to  move  the  cursor  back  to  the  line  which 
is  in  error  and  type  over  your  mistake.  Note  that  if  the  last  parameter  edited  was 
two  up  from  the  current  parameter  you  must  type  ‘up  2’  to  move  backward.  (See 
Section  4.2.3  for  greater  detail  on  the  Edit  Module’s  capabilities.) 

Complete  the  following  steps  in  order  to  generate  the  test  case  described  earlier. 
You  will  be  providing  the  values  for  the  standard  LOWTRAN7  input  parameters. 
If  you  are  unfamiliar  with  their  meaning,  please  refer  to  the  LOWTRAN7  manual1. 

Step  1: 

Type  either  ‘2’  or  ‘edit’  or  some  substring  of  edit  (such  as  ‘ed’)  at  the  Main 
Menu  prompt  (see  Figure  23)  in  order  to  execute  the  Edit  Module  of  SEN- 
TRAN7.  The  screen  for  editing  Card  1  will  appear  as  shown  in  Figure  26. 

Step  2: 

The  cursor  will  presently  be  located  on  the  line  MODEL.  Note  that  at  any  time, 
the  user  can  type  ‘help’  to  display  a  brief  description  of  the  current  parameter 
being  entered.  For  example,  type  ‘help’  now,  as  shown  in  Figure  27. 

The  program  will  display  information  about  the  MODEL  parameter,  as  shown  in 
Figure  28. 

Step  3: 

Once  you  have  returned  from  the  help  utility,  the  cursor  is  returned  to  the  line 
containing  the  MODEL  parameter.  In  this  tutorial,  we  would  like  to  use  the 
U.S.  Standard  Atmosphere  model,  so  type  ‘6’  and  press  RETURN.  After  this 
value  is  entered,  the  line  will  reformat  itself  to  reflect  the  change  in  the  value 
of  the  MODEL  parameter,  while  the  cursor  will  move  to  the  next  line. 

Step  4: 

We  have  completed  our  job  of  editing  Card  1,  so  type  ‘pd’  (for  “page  down”). 


Figure  26.  Example  of  the  Screen  Displayed  to  Edit  Card  1 


Figure  27.  Example  of  How  to  Implement  the  On-Line  Help  Utility  Within  the 
SENTRAN7  Edit  Module 
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Note  that  the  program  asks  us  if  the  current  card  is  acceptable.  Take  this 
opportunity  to  check  that  your  Card  1  screen  looks  like  Figure  29. 

Step  5: 

If  the  card  is  correct,  accept  the  default  (yes)  by  pressing  the  RETURN  key. 
Otherwise  enter  ‘n’  meaning,  “No,  the  card  is  not  acceptable,  I  would  like  to  fix 
it”.  When  you  enter  ‘n’,  the  program  returns  to  the  first  parameter  on  the  card. 
Go  back  to  Step  3  of  this  example  and  make  the  appropriate  modifications  to 
the  card  at  this  point. 

Step  6: 

Completion  of  Card  l  and  acceptance  of  its  contents  will  move  us  to  the  LOW- 
TRAN7  Card  2  screen,  as  shown  in  Figure  30. 

Step  7: 

IHAZE  will  be  the  active  line.  We  will  use  the  Rural  Extinction  model,  so 
enter  ‘1’. 

Step  8: 

We  will  not  need  any  further  changes  in  Card  2,  so  type  ‘pd’  to  move  to  the 
next  card  image.  Once  we  have  accepted  the  contents  of  Card  2,  the  Card  3 
screen  will  appear,  as  shown  in  Figure  31. 

Step  9: 

HI  will  be  the  first  line  in  Card  3.  We  would  like  to  perturb  this  variable  to 
represent  calculations  performed  at  altitudes  ranging  from  0  to  20  km  in  steps 
of  2.  To  do  this,  type  ‘0  to  20  step  2’. 

Step  10: 

Note  that  the  program  will  automatically  skip  the  next  two  parameters  (H2  and 
ANGLE),  since  we  are  computing  a  horizontal  path. 

Step  11: 

RANGE  will  now  be  the  active  variable.  Since  we  would  like  RANGE  to 
assume  all  values  from  1  to  10  km  inclusive,  type  ‘1  to  10’  (we  will  use  the 
default  step  size  of  1). 

Step  12: 

Our  work  on  Card  3  is  complete  and  we  can  proceed  to  Card  4  by  typing  ‘pd’. 
Compare  your  Card  3  image  with  Figure  32  before  proceeding. 

Step  13: 

Once  Card  3  has  been  accepted.  Card  4  will  appear  as  shown  in  Figure  33.  Our 
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Figure  28.  Example  of  the  On-Line  Help  Information  in  the  SENTRAN7  Edit 
Module 
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Figure  29.  Example  of  the  Final  Screen  Displayed  After  Editing  the  L0WTRAN7 
Input  Card  1 
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Figure  30.  Example  of  the  Initial  Screen  Displayed  to  Edit  the  LOWTRAN7  Card  2 


Figure  31.  Example  of  the  Initial  Screen  Displayed  to  Edit  the  LOWTRAN  Input 
Card  3 
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Figure  32.  Example  of  the  Final  Screen  Displayed  After  Editing  Card  3 


SE1ITRAH7 

SUll4/Uni:c  Version 

SPARTA,  Inc 

THE  FOLLOWING 

SEN TRAN 7  EDITING  UTILITY 

EDITING  CARD  4 

P ARAMS  CANNOT  BE  PERTURBED 

VI  ....  [] 

0.000 

V2  .... 

20.000 

DV  .... 

5.000 

ITWHM 

1  (REQUIRED  FOR  MODTRAN  ONLY) 

Figure  33.  Example  of  the  Initial  Screen  Displayed  to  Edit  Card  4 


calculation  is  concerned  only  with  a  single  frequency  (1300  cm-1).  Therefore, 
we  can  limit  our  spectral  interval  and  realize  a  substantial  savings  in  execution 
time.  VI  will  be  the  current  variable,  so  type  ‘1300’.  SENTRAN7  will  reformat 
the  line  and  present  VI  in  terms  of  cm-1  and  microns. 
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Step  14: 

For  V2,  enter  ‘1305’.  Note  that  even  though  we  are  only  concerned  with  the 
single  frequency,  1300  cm-1,  LOWTRAN7  cannot  calculate  spectral  intervals 
with  a  span  of  0,  therefore  we  must  enter  a  V2  of  1305  cm-1. 

Step  15: 

For  DV,  type  ‘5’. 

Step  16: 

Your  card  should  look  like  the  one  shown  in  Figure  34.  If  it  does,  accept  its 
contents  by  hitting  RETURN  and  accepting  the  default  ‘y\  If  it  does  not,  take 
the  time  now  to  fix  it  by  entering  ‘n’  and  repeating  Steps  13  through  15. 

Step  17: 

SENTRAN7  will  now  ask  if  you  would  like  to  compile  the  current  input  cards, 
as  shown  in  Figure  35.  We  want  to  compile  the  cards,  therefore  we  should 
press  RETURN,  accepting  the  default  (yes).  Answering  ‘y’  to  this  prompt  has 
the  same  effect  as  choosing  the  Compile  Module  from  the  Main  Menu. 

Step  18: 

The  program  will  now  prompt  you  for  the  name  of  the  input  file  ( *.INP ) 
to  create,  as  shown  in  Figure  36.  In  response  to  the  prompt  for  an  input 
file  name  and  compile  options,  type  ‘test  /m/e\  meaning  “compile  a  LOW- 
TRAN7/MODTRAN  input  file  named  TEST.INP  in  MESH  form  with  ERROR 
logging  and  automatically  generate  a  MTH  file  named  TEST.MTH ”.  Recall  that 
the  MESH  (/m)  option  generates  all  possible  combinations  of  all  perturbed  in¬ 
put  parameters  and  the  ERROR  (/e)  option  causes  a  list  of  active  absorbers  and 
their  spectral  range  of  activity  to  be  written  to  a  file  called  SEN. ERR,  along 
with  any  compile  time  errors. 

Step  19: 

SENTRAN7  then  displays  a  screen  similar  to  the  one  shown  in  Figure  37,  while 
it  compiles  the  input  cards.  The  active  molecular  absorbers  in  the  selected 
spectral  range  will  be  displayed.  If  the  list  of  absorbers  fills  more  than  one 
screen,  the  message  displayed  at  the  bottom  of  Figure  37  will  be  shown. 

Step  20: 

Press  RETURN  to  exit  the  screen  and  complete  the  compile  option.  At  this 
point,  we  are  back  at  the  Main  Menu.  We  will  now  want  to  run  the  appropriate 
transmission  model. 
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SEtJTRAIJV  SUU4/Uni::  Version  SPARTA  Inc 


SENTRAN7  EDITING  UTILITY 
EDITING  CARD  4 

THE  FOLLOWING  P ARAMS .  CANNOT  BE  PERTURBED 

VI  ...  1299.999  CM-1  7.692  MICRONS 

V2  _  1304.999  CM-1  7.662  MICRONS 

DV  _  5.000 

IFWHM  1  (REQUIRED  FOR  MODTRAN  ONLY) 

ALL  PARAMETERS  FOR  CARD  4  O.K.  (Y/N)  [g] 

Figure  34.  Final  Screen  Displayed  After  Editing  Card  4.  Note  that  SENTRAN7’s 
output  format  routine  causes  the  spectral  frequencies  to  be  rounded  off  incorrectly. 
The  internal  representation  of  the  numbers  is  still  correct 


SEI1TRAU7  SUIJ4 /Unix  Version  SPARTA.  Inc 


SESTRAN7  EDITING  UTILITY 
EDITING  CARD  4 

THE  FOLLOWING  PARAMS .  CANNOT  BE  PERTURBED 

VI  1299.999  CM-1  7.692  MICRONS 

V2  .  .  1304 . 999  CM-1  7 . 662  MICRONS 

DV  ...  5.000 

IFWHM  1  (REQUIRED  FOR  MODTRAN  ONLY) 

ALL  PARAMETERS  FOR  CARD  4  O.K.  (Y/N)  [Y] 

COMPILE  INPUT  DECK?  [g] 

Figure  35.  Example  of  the  Screen  Displaying  the  Compile  Option  After  All  Cards 
Have  Been  Set 


SEIITRAIJ7  SOU. 1 /Uni:.-  VV-rsi>>n  SPARTA,  Inc 


DEVELOPING  INPUT  DECK 
BASED  OH  LAST  EDITING  SESSION 


ENTER  FILE  NAME  rOR  INPUT  DECK  [ .IBP] 
AND  SENTRAN7  COMPILE  OPTIONS 


Figure  36.  SENTRAN7  Prompt  for  the  Input  File  Name  and  Compiler  Options 
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b'EIITRAIl  1 


SUM 4 /Unix  Vorsion 


SPARTA ,  Inc 


DEVELOPING  INPUT  DECK 
BASED  ON  LAST  EDITING  SESSION 

COMPILING  TEST . I UP  AS  MESH  ERRLOC 

LIST  OF  ACTIVE  MOLECULAR  ABSORBERS  (Vl=  1300.0  V2=  1305.0) 


H20 

ACTIVE 

REGIONS 

1300.0 

TO 

1305.0 

CM-1 

C02 

ACTIVE 

REGIONS: 

1300  0 

TO 

1305.0 

CM-1 

N20 

ACTIVE 

REGIONS : 

1300.0 

TO 

1305.0 

CM-1 

CH4 

ACTIVE 

REGIONS : 

1300.0 

TO 

1305.0 

CM-1 

802 

ACTIVE 

REGIONS: 

1300.0 

TO 

1305.0 

CM-1 

NH3 

ACTIVE 

REGIONS : 

1300.0 

TO 

1305.0 

CM-1 

.  .  MORE.  .  .  HIT  < RETURN >  TO  COHTIHUIT] 


Figure  37.  Example  of  the  On-Line  Feedback  Provided  While  SENTRAN7  Com¬ 
piles  the  User  Specified  Input  Cards 

5.3.4  Using  the  Run  Module 

SENTRAN7  offers  the  capability  of  running  LOWTRAN7  or  MODTRAN  from 
within  the  menu  interface.  (Note  that  it  is  the  user’s  responsibility  to  make  sure 
the  desired  model  is  present,  although  SENTRAN7  will  notify  the  user  if  it  cannot 
find  the  desired  code.)  Follow  the  next  steps  in  order  to  run  the  calculations. 

Step  1: 

The  user  first  selects  which  code  to  execute,  either  LOWTRAN7,  MODTRAN 
or  MODTRAN  run  as  LOWTRAN7  by  entering  ‘4’  at  the  Main  Menu  (see 
Figure  23).  The  submenu  for  choosing  which  code  to  run  will  appear  as  shown 
in  Figure  38.  For  this  case  we  will  run  LOWTRAN7,  so  we  will  enter  ‘1’. 
(NOTE:  If  you  only  have  the  code  for  MODTRAN,  then  choose  option  3  to 
run  MODTRAN  as  LOWTRAN7). 

Step  2: 

We  are  now  back  at  the  Main  Menu.  Notice  that  option  5  to  run  the  code  will 
reflect  which  option  was  chosen  in  the  previous  submenu  (either  LOWTRAN7, 
MODTRAN,  or  MODTRAN  AS  LOWTRAN7). 
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SEUTRAH7  sung /Urn:;  Version  SPARTA,  Inc 


SELECT  LOWTRAN7 /MODTRAH 
CURRENT  MODE  OF  EXECUTION  :  LOWTRAH7 

1  -  LOWTRAN7 

2  -  MODTRAH 

3  -  MODTRAH  AS  LOWTRAN7 

»□ 


Figure  38.  Example  of  the  Screen  Displaying  the  Programs  Available 
Step  3: 

We  now  wish  to  run  LOWTRAN7,  therefore  we  enter  ‘5’  or  ‘run’  at  the  Main 
Menu  prompt. 

Step  4: 

The  program  will  now  prompt  you  for  the  name  of  the  input  file  to  use  for 
this  run,  as  shown  in  Figure  39,  with  the  default  being  the  last  input  file  that 
was  compiled  (the  file  created  in  Section  5.3.3).  We  will  accept  the  default  file 
C TEST.INP )  by  pressing  RETURN. 


SEHTRAH7  SUH4/UruJ:  Version  SPARTA,  Inc 


PROGRAM  TO  BE  EXECUTED  :  LOWTRAH7 
ENTER  FILE  SAME  FOR  INPUT  DECK  [  INP]  ?  gEBT . INP 


Figure  39.  Example  of  the  Prompt  Requesting  the  Name  of  the  Input  File 
Step  5: 

We  now  wait  for  the  program  execution  to  complete,  at  which  time  we  will 
see  the  screen  shown  in  Figure  40.  The  time  required  to  complete  a  run  will 
depend  on  many  factors,  such  as  the  speed  of  the  host  computer  and  the  type 
of  calculation. 
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SEHTRAIJ7 


SUU4/Unix  Version 


SPAKTA,  Inc 


RUHHIHG  L0WTRAH7  TOR  TEST . I HP 
. .  PLEASE  WAIT. . . 


EXECUTION  COMPLETES 
PRESS  <RETURH>  TO  COHTIBUlf] 


Figure  40.  Example  of  the  Screen  Displaying  the  Completion  of  a  LOWTRAN7 
Calculation 

Step  6: 

The  standard  LOWTRAN7  tape7  and  tape8  have  now  been  created  as  TAPE7.0UT 

and  TAPE8.0UT,  respectively,  and  contain  the  output  data  for  the  above  case. 

We  can  now  proceed  to  the  Graph  and  Analyze  Module  of  SENTRAN7. 

5.3.5  Using  the  Graph  and  Analyze  Module  For  Tutorial  #1 

Now  that  we  have  generated  some  LOWTRAN7  data,  we  can  proceed  to  graph 
and  analyze  it.  Be  sure  that  you  have  performed  the  proceeding  steps  of  this  tutorial 
and  executed  LOWTRAN7  so  that  your  results  will  be  consistent  with  those  of  this 
tutorial.  Since  the  G&A  Module  in  SENTRAN7  is  fairly  versatile,  this  tutorial  is 
a  cursory  overview  at  best.  The  best  way  to  master  the  G&A  option  is  by  utilizing 
the  on-line  help  utility  and  “playing”  with  LOWTRAN7/MODTRAN  data  sets.  In 
this  section,  we  will  create  three  plots  from  the  data  stored  in  the  TAPE7.0UT  file 
from  the  LOWTRAN7  run  just  completed. 

Plot  1 

A  3-D  plot  of  the  total  transmittance  as  a  function  of  the  perturbed  param¬ 
eters  RANGE  and  HI  for  a  wavenumber  of  1300  cm-1,  plotted  at  a  45° 
rotation  of  both  axes 
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Plot  2 


A  3-D  plot  of  the  derivative  of  total  transmittance  with  respect  to  the 
RANGE  (the  jc  axis)  as  a  function  of  the  perturbed  parameters  RANGE 
and  HI  for  a  wavenumber  of  1300  cm-1,  plotted  at  45°  rotation  of  both 
axes 

Plot  3 

A  3-D  plot  of  the  optical  depth  (total  absorbance)  as  a  function  of  the 
perturbed  parameters  RANGE  and  HI  for  a  wavenumber  of  1300  cm-1, 
plotted  at  a  45°  rotation  of  both  axes 

We  will  begin  by  creating  Plot  1  described  above.  Follow  Steps  1  through  12  to 
create  this  plot: 

Step  1: 

Type  ‘4’  or  ‘graph’  (or  some  sub-string  of  the  word  ‘graph’,  such  as  ‘g’)  at  the 
Main  Menu  prompt  (see  Figure  23).  The  initial  screen  displaying  the  available 
plots  for  the  input  cards  defined  in  the  Edit  Module  will  appear,  as  shown  in 
Figure  41. 


SEI1TRAI17 

SUIJ4/Unix  Version 

SPARTA,  Inc  j 

SEBTRAN7  GRAPHICS  fi  ANALYSIS  MODULE 

PLOT  TYPE: 

1)  RAW-XYZ  2)  TRANSMITTANCE 

PLOT  TYPE? 

□ 

Figure  41.  Initial  Screen  Display  for  SENTRAN7’s  Graph  and  Analyze  Module 
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Step  2: 

We  would  like  to  plot  a  transmittance  profile  (specifically  total  transmittance), 
so  in  response  to  the  prompt  for  a  plot  type,  enter  a  ‘2’.  Figure  42  shows  the 
following  screen  that  will  appear.  This  screen  prompts  the  user  for  the  x  axis 
parameter. 


SEHTRAN7 

SUN4/Unix  Version 

SPARTA,  Inc  | 

PLOT  TYPE: 

SENTRAN7  GRAPHICS  £  ANALYSIS  MODULE 

TRANSMITTANCE 

X-AXIS 

1)  WAVENUMBER  2)  RANGE 

X-AXIS  [] 

Figure  42.  Example  of  the  Screen  Prompt  Displayed  Asking  for  the  X  Axis  Pa¬ 
rameter 


Step  3: 

We  would  like  the  jc  axis  to  be  the  perturbed  parameter  RANGE,  so  enter  a  ‘2’ 
in  response  to  the  x  axis  prompt.  The  program  will  now  prompt  you  for  the  y 
axis  parameter,  as  shown  in  Figure  i13. 

Step  4: 

We  would  like  the  y  axis  to  be  pe,  'bed  parameter  HI ,  so  enter  a  ‘2’  in  response 
to  the  y  axis  prompt.  Figure  44  shows  the  subsequent  screen  to  appear. 

Step  5: 

Since  we  have  already  used  two  independent  axes  for  our  plot,  we  must  select  a 
fixed  wavenumber  for  our  data  set.  In  response  to  the  prompt  for  wavenumber, 
type  ‘1300’.  The  G&A  option  will  then  prompt  you  for  the  units  in  which 
frequency  dependent  data  should  be  expressed  (cm-1  or  microns),  as  shown  in 
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SEHTRA1I7  SUH4/Unix  Version  SPARTA,  Inc 


Figure  43.  Example  of  the  Screen  Prompt  Displayed  for  the  y  Axis  Parameter 


SE1JTRAII7 

SUII4/Umx  Version 

SPARTA,  Inc 

PLOT  TYPE: 

SINTRAN7  GRAPHICS  £  ANALYSIS  MODULE 

TRANSMITTANCE 

X-AXIS 

RANGE 

Y-AXIS 

HI 

WAVENUM. 

1300  TO  1305 

WHICH  WAVENUMBER  ?  [] 

Figure  44.  Example  of  the  G&A  Screen  Prompting  for  the  Wavenumber 
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SEHTRAN7  SUN 4 /Unix  Version 


SPARTA,  Inc 


SENTRAN7  GRAPHICS  £  ANALYSIS  MODULE 


(PLOT  TYPE :  TRANSMITTANCE 
X-AXIS  :  RANGE 
Y-AXIS  :  HI 
HA VENOM,  :  1300 

lONITS  or  :  1)  CM-l  2)  MICRONS 


[UNITS  7  [] 


Figure  45.  Example  of  the  G&A  Screen  Prompting  for  the  Units  to  Use  in  Plotting 
Figure  45. 

Step  6: 

Select  ‘1’,  for  cm-1. 

Step  7: 

You  will  now  be  presented  with  a  number  of  items  which  may  be  plotted  on  the 
z  axis,  as  shown  in  Figure  46.  The  actual  choices  presented  will  vary  according 
to  the  type  of  calculation  which  you  are  performing  (based  on  IEMSCT’s  value). 
Recall  that  we  want  to  plot  total  transmittance  as  a  function  of  RANGE  and 
HI,  so  select  item  ‘1’  to  plot  TOTAL  TRANSMITTANCE. 

Step  8: 

The  final  step  in  the  data  selection  process  involves  choosing  the  file  from 
which  to  read  the  LOWTRAN7  output  data,  as  shown  in  Figure  47.  In  almost 
all  cases  the  user  just  needs  to  accept  the  default  file,  either  TAPE7.0UT  or 
TAPE8.0UT.  In  this  case  we  will  accept  the  default  TAPE7.0UT  by  pressing 
RETURN.  You  have  completed  the  data  selection  portion  of  the  G&A  option, 
and  the  program  will  now  enter  the  G&A  command  mode. 

Step  9: 

At  the  command  line,  you  can  obtain  a  list  of  available  G&A  commands  by 
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|  SEHTRA1J7 

SUIM/Unix  Version 

SPARTA,  Inc  | 

SEHTRAH7 

GRAPHICS  fi 

ANALYSIS 

MODULE 

PLOT  TYPE: 

TRANSMITTANCE 

1 

X-AXIS 

RANGE 

Y-AXIS 

HI 

WA VENOM 

1300 

□HITS  OF  : 

CM-1 

Z-AXIS 

1)  TOTAL  2)  H20 

3) 

UNIT 

4) 

03 

5) 

TRACE 

6)  N2  COST  7)  H20 

CONI 

8) 

MOL  SCAT 

9) 

AER 

HYD  10) 

HN03 

11)  AER  ABS  12)  LOG 

TOTAL 

13) 

C02 

14) 

CO 

15) 

CH4 

16)  N20  17)  02 

21)  S02 

18) 

NH3 

19) 

NO 

20) 

N02 

WHICH  TRANSMITTANCE  ?  [] 

Figure  46.  Example  of  the  G&A  Screen  Prompting  for  the  Selection  of  the  Z  Axis 
Parameter 


SE1ITRAU7 

SUlJ4/Unix  Version 

SPARTA,  Inc  j 

SEN TRAN 7  GRAPHICS  fi  ANALYSIS 

MODULE  U 

PLOT  TYPE: 

TRANSMITTANCE  FILE  NAME  : 

§APE7 . OUT  | 

X-AXIS 

RANGE 

Y-AXIS 

HI 

WAVENUM. 

1300 

UNITS  OF  : 

CM-1 

Z-AXIS 

TOTAL  TRANSMITTANCE 

Figure  47.  Example  of  the  G&A  Screen  Prompting  for  the  Name  of  the  Data  File 
to  Plot 
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typing  ‘help’.  Figure  48  shows  the  help  screen  that  will  appear. 

Step  10: 

To  obtain  specific  information  on  any  of  the  G&A  commands,  you  type  ‘help’ 
and  the  command  you  wish  information  on.  For  example,  type  ‘help  plot’  as 
shown  in  Figure  49.  The  program  will  display  the  available  help  for  the  PLOT 
command,  as  shown  in  Figure  50. 

Step  11: 

If  you  have  a  VT240  type  terminal,  try  plotting  the  data  by  entering  ‘plot 
VT240’.  If  you  do  not  have  a  VT240  compatible  terminal,  plot  the  graph  to 
a  file  first  by  typing  ‘plot  test’,  this  will  create  the  Tektronix  file  TEST.TEK. 
In  either  case,  the  cursor  will  move  to  a  new  field  and  request  rotation  angles, 
as  shown  in  Figure  51.  Enter  ‘45,45’  meaning  “first  rotate  the  data  counter¬ 
clockwise  about  the  z  axis  and  then  rotate  the  data  counterclockwise  around  the 
original  x  axis  (/.<?.,  tilt  out  of  screen)”.  Your  plot  should  look  like  Figure  52. 

Step  12: 

If  you  were  able  to  plot  the  graph  to  the  screen  using  the  VT240  command, 
press  the  RETURN  key  when  you  are  done  looking  at  the  plot.  If  you  plotted 
the  graph  to  a  file  {TEST.TEK),  you  know  the  plot  has  been  completed  when 
the  comment  “.TEK  FILE  :  TEST.TEK”  appears  on  the  left  of  the  screen  and 
you  return  to  the  G&A  command  line,  as  shown  in  Figure  53. 

We  will  now  graph  Plot  2,  a  3D  plot  of  the  derivative  of  total  transmittance  with 
respect  to  the  RANGE  (the  x  axis)  versus  the  perturbed  parameters  RANGE  and 
HI  for  a  wavenumber  of  1300  cm-1,  plotted  at  45°  rotation  of  both  axes.  Step  13 
accomplishes  this  task: 

Step  13: 

Differentiate  with  respect  to  the  x  axis  by  entering  ‘dx’  at  the  command  line. 
Note  that  the  program  modifies  the  z  axis  label  to  reflect  this  manipulation. 
Let’s  plot  the  data  set  by  typing  ‘plot  VT240’  (or  ‘plot  testdx’  if  plotting  to  a 
file).  Press  the  RETURN  key  to  accept  the  default  rotation  arguments,  which 
should  be  ‘45,45’.  The  resultant  plot  should  look  like  Figure  54. 

We  will  now  graph  Plot  3,  a  3-D  plot  of  the  optical  depth  (total  absorptance)  versus 
the  perturbed  parameters  RANGE  and  HI  for  a  wavenumber  of  1300  cm-1,  plotted 
at  45°  rotation  of  both  axes.  Follow  Steps  14  and  15  to  create  this  plot: 

Step  14: 

Recall  that  to  obtain  the  optical  depth  data  we  use  the  T2A  command  to  trans- 
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SE1ITRWI7  sUIU;Uiu::  Vtisiuii  SPARTA  Inc 


sentran  help  utility 

Halp  la  aval labia  on  tha  following  conaanda  : 


A2T 

DXDY 

MINIMUM 

TITLE 

COSMETIC 

OYDX 

NEW 

T2A 

OX 

EXIT 

NOSORT 

VCUTE 

DY 

LOG 

PLOT 

XLABEL 

DDX 

MAXIMUM 

REFRESH 

YLABEL 

DDY 

MEAN 

SNAP 

Z LABEL 

Entar  HELP  [cotaaand  you  want  halp  on]  at  tha  COMMAND  prompt 
EXAMPLE:  HELP  T2A 

HIT  <HETUHH>  TO  CONTINOSf] 


Figure  48.  Example  of  the  Screen  Displaying  the  “Help”  Options  Available  for 
Graph  and  Analyze  Commands 


SEUTRA117  t>Ul!4/Uni>:  Version  SPARTA.  Inc 


SENTRAN7  GRAPHICS  S  ANALYSIS  MODULE 

PLOT  TYPE:  TRANSMITTANCE  TILE  SAME  :  TAPE 7 . OUT 

K-AXI8  :  WAVENUMBER 

Y-AXI8  :  RANGE 

□HITS  Or  :  CM-1 

Z-AXIS  :  TOTAL  TRANSMITTANCE 

COMMAND  ?  halp  plotQ 


Figure  49.  Example  of  the  G&A  Screen  Showing  a  Request  for  “Help”  on  the 
PLOT  Command 


76 


SEUTRAII7  SUlJ4/Unix  Version 


SPARTA.  Inc 


SZXTRAN  HELP  UTILITY 


The  PLOT  coamand  initiates  the  plotting  caquanca.  PLOT  requires 
at  laast  ona  argument.  Tha  argument  will  ganarally  be  a  . TZK 
output  file.  However,  tha  name  VT240  is  a  reserved  argument 
which  will  send  graphical  output  to  tha  terminal.  An  output 
file  name  and  the  VT240  argument  can  both  be  provided,  causing 
output  to  be  directed  to  the  screen  and  tha  TZK  file  simultaneously. 

EXAMPLE  : 

PLOT  TEST  VT240 

Will  form  a  graphics  file  TEST. TZK  and  display  the  plot  on  the  user's 
terminal.  After  tha  PLOT  coamand  is  entered,  tha  user  is  proopted  for 
rotation  angles.  PLOT  then  proceeds  and  returns  to  COMMAND  input  when 
finished. 


HIT  <RZTOBS>  TO  COSTISUlf] 


Figure  50.  Example  of  the  Screen  Showing  “Help”  Information  About  the  PLOT 
Command 


TYPE.  TRAHSMITTAHCE 


AXIS  :  RASGE 


AXI8  :  HI 


VESUM.  :  1300 


ITS  OE  :  CM-1 


SEIJTRAIJ7  SUN 4 /Uni::  Version 


SPARTA  Inc 


SEBTRAH7  GRAPHICS  G  ANALYSIS  MODULE 


PILE  SAME  :  TAPE7 . OUT 


ROT AT I OH  45,  4SQ 


AXIS  :  TOTAL  TRASSKITTABCZ 


MMAHD  7  plot  test 


Figure  51.  Example  of  the  G&A  Screen  Prompting  for  Rotation  Angies  to  be  Used 
While  Plotting 
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X 

RANGE 

1 . 0000E  +  00 

TO 

1 . 0000E+01 

(TICK=  1.0) 

V 

HI 

0 ■ 0000E+00 

TO 

2. 0000E+01 

( TICK=  2.0) 

z 

TOTAL  TRANSMITTANCE 

0 . 1700E-02 

TO 

0 . 9836E+00 

( TICK=0. 0981 ) 

Figure  52.  Example  of  Plot  1,  a  3-D  Plot  of  Total  Transmittance  as  a  Function  of 
HI  and  RANGE  for  a  45°  Rotation  of  Both  Axes 

form  the  z  axis  transmittance  data  to  optical  depth.  Since  our  z  axis  is  currently 
the  derivative  of  transmittance,  we  first  need  to  refresh  the  data  so  that  we 
have  total  transmittance  on  the  z  axis  again.  This  can  be  done  by  first  typ¬ 
ing  ‘new’  at  the  command  line  prompt.  The  initial  G&A  screen  will  appear 
(see  Figure  41).  Re-answer  all  of  the  data  input  options  (i.e.,  Repeat  Steps  2 
through  8  of  the  G&A  Module  for  Tutorial  #1)  so  that  you  have  the  pertubed 
parameters  RANGE  and  HI  for  the  x  and  y  axes,  respectively,  and  TOTAL 
TRANSMITTANCE  on  the  z  axis. 

Step  15: 

Type  ‘t2a’  to  convert  the  z  axis  transmittance  values  to  optical  depth  values. 
Type  ‘plot  VT240’  and  then  ‘45,45’  to  see  the  results  shown  in  Figure  55. 

Again,  try  seeing  which  commands  are  available  by  typing  ‘help’.  Experiment 
with  the  data  set  by  trying  as  many  of  these  commands  as  you  can,  using  the 
on-line  help  whenever  you  have  difficulties. 


Figure  53.  Example  of  the  G&A  Screen  Displayed  When  the  Requested  Graph 
Has  Been  Plotted  to  a  File 


x  s  range  i.0000E*ee  to  i. malm  (tick-  1757 

v  ••  HI  0.0000E'00  TO  2.0000E+01  (TICK-  8.0) 

Z  :  DX  TOTAL  TRANSMITTANCE  -0. 182SE»00  TO  -0.9761E-03  l TICK-0. 0181 ) 


Figure  54.  Example  of  Plot  2,  a  3-D  Plot  of  Derivative  of  Total  Transmittance 
With  Respect  to  RANGE  as  a  Function  of  RANGE  and  HI  for  a  45°  Rotation  of 
Both  Axes 
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X  s  RANGE 
V  !  HJ 

Z  :  TOTAL  ABSORBANCE 


i •  0000E+B0  to  i.eeeeEm  (Tier*  1.01 
a.0000Et00  TO  2.0000E«01  (TICIC=  2.0) 

0.16S3E-01  TO  6. 3?71E»00  t  TICIC*0. 6360) 

Figure  55.  Example  of  Plot  3,  a  3-D  Plot  of  Optical  Depth  as  a  Function  of 
RANGE  and  HI  for  a  45°  Rotation  of  Both  Axes 

5.4  SENTRAN7  Tutorial  #2 

The  following  tutorial  is  not  in  as  much  depth  as  the  first  tutorial  given  in  that 
a  step-by-step  discussion  will  not  be  given  as  with  the  first  tutorial.  Instead,  the 
input  parameters  for  this  tutorial  are  specified  for  you  to  enter  with  SENTRAN7’s 
Edit  Module.  Examples  of  the  G&A  features  and  some  of  the  possible  plots  are 
shown. 

5.4.1  Using  the  Edit  Module 

We  will  begin  by  editing  the  input  cards  to  generate  the  following  test  case: 

Thermal  Radiance  with  single  scattering  for  models  6  (U.S.  Standard),  3 
(Midlatitude  Winter)  and  1  (Tropical  Atmosphere)  and  a  vertical  path  from 
0  to  32  km  with  IHAZE  =  /,  over  400  to  2000  cm-1  spectral  region  at  5 
cm-1  intervals 

Figure  56  summarizes  the  input  parameters  for  this  test  case.  The  steps  that  follow 
briefly  outline  the  instructions  for  editing  the  input  cards  in  SENTRAN7  in  order 
to  generate  the  test  case  described  above. 

Step  1: 

Type  either  ‘2’  or  ‘edit’  at  the  Main  Menu  (see  Figure  23)  in  order  to  enter  the 
Edit  Module  of  SENTRAN7.  The  screen  for  editing  Card  1  will  appear  (see 
Figure  24). 


CARD  1 

CARD  2 

MODEL  -631 

I  HAZE  -  1 

ITYPE  -  2 

ISEASN  -  1 

IEMSCT  -  1 

IVULCN  -  1 

IMULT  *  0 

ICSTL  -  ICLD  -  IVSA  -  0 

M 1 -M2-M3-M4-MS-M6-MDET-0 

VIS  -  WSS  -  WHH  -  0.0 

IM  -  0 

RAINRT  -  0.0 

NOPRT  -  -1 

GNDALT  »  0.0 

TBOUND  -  SALB  -  0.0 

CARD  3 

CARD  4 

HI  -  0.0 

VI  -  400.0 

H2  -  32.0 

V2  -  2000.0 

ANGLE  -  0.0 

DV  -  5.0 

RANGE  -  0.0 

IFVHM  -  1 

BETA  -  RO  -  0.0 

LEN  -  0 

Figure  56.  Summary  of  Input  Parameters  for  Tutorial  #2 
Step  2: 

For  the  MODEL  parameter  we  wish  to  use  three  different  models,  U.S.  Stan¬ 
dard,  Midlatitude  Winter  and  Tropical  Atmosphere,  so  enter  ‘6  3  1*  on  the  first 
line  of  Card  1. 

Step  3: 

ITYPE  will  now  be  the  active  line.  Enter  ‘2’  to  indicate  a  vertical  path  between 
two  altitudes. 

Step  4: 

For  IEMSCT,  enter  ‘T  to  execute  the  program  in  radiance  mode. 

Step  5: 

Set  IMULT  equal  to  ‘0’  for  single  scattering. 

Step  6: 

Hit  RETURN  until  you  reach  the  line  containing  the  NOPRT  parameter.  En¬ 
ter  ‘-1*  so  that  data  will  be  written  to  TAPE8.0UT  as  well  as  TAP E7 .OUT. 
TAPE8.0UT  will  contain  data  for  the  differential  transmittance  (DTAU)  and 
the  Black  Body  Function. 

Step  7: 

We  are  now  done  editing  Card  1.  Enter  ‘pd’  to  advance  to  Card  2.  Verify  that 
the  parameters  on  Card  1  match  those  summarized  in  Figure  56  for  Card  1.  If 
they  do,  accept  Card  1  by  hitting  RETURN.  If  they  do  not,  enter  ‘n’  and  repeat 
Steps  2  through  7  of  this  tutorial. 
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Step  8: 

We  will  now  be  editing  Card  2.  IHAZE  will  be  the  active  line  in  Card  2.  We 
will  use  the  Rural  Extinction  aerosol  model,  so  enter  ‘1’  for  IHAZE. 

Step  9: 

ISEASN  will  be  the  active  line;  enter  ‘1’  for  a  Spring  -  Summer  aerosol  profile 
season. 

Step  10: 

Enter  ‘1*  for  IVULCN  to  select  a  background  stratospheric  profile  and  extinc¬ 
tion. 

Step  11: 

The  rest  of  the  parameters  on  Card  2  should  be  set  to  ‘O’.  If  they  are,  enter  ‘pd’ 
to  advance  to  Card  3.  If  they  are  not,  continue  editing  Card  2  and  set  these 
variables  to  ‘O’.  Again  check  the  contents  of  your  Card  2  with  the  summary 
of  input  parameters  in  Figure  56  for  Card  2.  If  they  are  correct,  accept  the 
contents  of  Card  2  by  hitting  RETURN.  If  they  do  not,  enter  ‘n’  and  repeat 
Steps  8  through  11. 

Step  12: 

We  will  now  be  editing  Card  3,  with  HI  being  the  active  line.  We  wish  to  use 
a  vertical  path  from  0  to  32  km,  so  enter  ‘0’  for  HI. 

Step  13: 

Then  enter  ‘32’  for  H2. 

Step  14: 

The  rest  of  the  parameters  on  Card  3  should  be  set  to  ‘O’.  If  they  are,  enter  ‘pd’ 
and  accept  Card  3  after  comparing  the  contents  of  your  card  to  the  summary 
given  in  Figure  56  for  Card  3. 

Step  15: 

This  will  advance  us  to  Card  4.  We  wish  to  perform  calculations  over  a  400 
to  2000  cm-1  spectral  region  at  5  cm-1  intervals.  So  for  the  initial  frequency 
VI,  enter  ‘400’.  The  program  will  automatically  reformat  the  line  and  display 
VI  in  cm-1  and  microns. 

Step  16: 

For  the  final  frequency  V2,  enter  ‘2000’. 

Step  17: 

For  the  frequency  increment  DV,  enter  ‘5’. 
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Step  18: 

We  are  done  editing  Card  4.  Enter  ‘pd’  and  accept  the  contents  of  Card  4. 
Note  that  we  are  not  concerned  with  the  value  of  IFWHM  since  we  will  be 
running  LOWTRAN7  and  not  MODTRAN. 

Step  19: 

Once  we  have  accepted  Card  4,  SENTRAN7  will  prompt  you  if  you  want  to 
compile  the  input  parameters.  Accept  the  default  ‘y’  by  hitting  RETURN  so 
that  we  now  enter  the  Compile  Module  of  SENTRAN7. 

5.4.2  Using  the  Compile  and  Run  Modules 
Step  20: 

The  program  now  prompts  you  for  the  name  of  the  input  file  ( *.INP )  to  cre¬ 
ate  and  for  the  compiler  options.  Compile  the  input  parameters  to  produce 
the  file  TEST2.1NP  in  NOMESH  form  without  ERROR  logging  by  entering 
‘test2  /nomesh’. 

Step  21: 

After  the  program  finishes  compiling  the  input  file,  SENTRAN7  returns  to  the 
Main  Menu.  We  can  now  run  LOWTRAN7  for  the  test  case  we  have  just 
created.  Make  sure  that  Option  5  on  the  Main  Menu  says  RUN  LOWTRAN7 
(or  RUN  MODTRAN  as  LOWTRAN7).  If  it  does  not,  first  choose  Option  4  to 
SELECT  LOWTRAN7 I  MODTRAN  and  select  LOWTRAN7  (or  MODTRAN  as 
LOWTRAN7)  from  the  subsequent  submenu. 

Step  22: 

We  are  now  ready  to  execute  LOWTRAN7,  so  enter  ‘5’  or  ‘run’  at  the  Main 
Menu  prompt.  Wait  for  the  program  to  notify  you  that  execution  has  completed 
before  hitting  RETURN  and  returning  to  the  Main  Menu  (see  Figure  40). 

5.4.3  Using  the  Graph  and  Analyze  Module  for  Tutorial  #2 
We  wish  to  create  two  plots  from  the  data  created  from  Tutorial  #2: 

Plot  1 

A  3-D  plot  of  the  total  transmittance  as  a  function  of  wavenumber  and 
the  perturbed  parameter  MODEL,  plotted  at  viewing  angles  of  -11.25°  and 
11.25° 

Plot  2 

A  3-D  plot  of  tne  differential  transmittance  (DTAU)  as  a  function  of  layer 
and  wavenumber  for  a  Midlatitude  Winter  atmosphere,  plotted  at  viewing 
angles  of  -45°  and  1 1 .25° 
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Follow  these  steps  to  create  these  plots  and  compare  your  results  with  Figures  57 
and  58. 

Step  23: 

Enter  the  G&A  Module  by  entering  ‘6’  or  ‘graph’  at  the  Main  Menu.  The 
initial  screen  and  types  of  plots  available  for  this  case  are  shown  in  Figure  59. 

Step  24: 

We  first  want  to  create  Plot  1.  The  option  to  plot  total  transmittance  can  be 
found  under  the  ATM  RADIANCE  plot  type,  so  enter  ‘2’  for  this  plot  type 
at  the  command  prompt.  Let  the  x  axis  be  the  wavenumber  in  uiuls  of  cm-1 
and  the  y  axis  be  the  different  model  numbers.  Then  let  the  z  axis  be  total 
transmittance.  Read  in  the  TAPE7.0UT  file  and  plot  the  data  with  rotation 
angles  of  -11.25°  and  11.25°.  This  plot  is  shown  in  Figure  60. 

Step  25: 

We  next  want  to  create  Plot  2.  We  first  need  to  refresh  the  data  set  by  typing 
‘new’  at  the  G&A  command  prompt  to  return  to  the  initial  G&A  menu.  Now 
choose  the  plot  type  to  plot  DTAU  by  entering  a  ‘3’.  Note  that  the  x  axis 
parameter  is  automatically  set  to  LAYER  #  and  the  y  axis  parameter  is  set  to 
WAVENUMBER.  Choose  the  cm-1  units  at  the  prompt  for  the  units.  For  the 
z  axis  we  can  choose  to  plot  DTAU  or  DTAU/LAYER  THICKNESS.  We  want 
to  plot  DTAU,  so  enter  ‘1’  at  the  prompt  for  the  z  axis  **■ rameter.  Read  in 
TAP E8. OUT  and  plot  the  graph  with  rotation  angles  of  -*  .id  1 1.25°.  This 
plot  is  shown  in  Figure  61.  Note  that  the  x  axis  increases  ...u)  the  foreground. 
Also  note  that  the  program  can  ONLY  plot  the  first  group  of  data  in  the  output 
file  (MODEL  =  3),  and  does  not  plot  the  cases  for  MODEL  =  6  or  1.  Any 
time  DTAU,  the  Black  Body  Function  or  the  Flux  plots  (IEMSCT  =  2)  are 
plotted,  only  the  first  perturbation  case  in  the  output  file  is  plotted.  Which 
perturbation  case  is  first  in  the  output  file  depends  on  if  the  input  file  was 
compiled  as  NOMESH  or  MESH.  To  plot  these  other  cases  you  must  edit  the 
input  cards  so  that  the  desired  perturbation  to  plot  is  first  and  then  compile  the 
input  cards  as  MESH.  For  best  results  when  plotting  layerwise  plots  such  as 
this,  the  user  should  not  use  any  perturbations  but  simply  edit  the  input  cards 
for  one  particular  case  to  plot. 
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X  :  LAUENUMBER  4.0008E*0H  TO  E.0000E+03  t  TICK-  150. 6 > 

V  :  MODEL  1  3  S 

Z  :  TOTAL  TRANSMITTANCE  0.0000E+00  TO  0.9096E*00  ( T ICK=0 . 0909 ) 

Figure  57.  Example  of  Plot  1,  a  3-D  Plot  of  Total  Transmittance  as  a  Function  of 
Wavenumber  and  Model  Atmosphere  Number  for  Viewing  Angles  of  -11.25°  and 
11.25° 


V  :  UAUENUMBER  4.0000E*8a  TO  E.eeeeE+03  (TICK*  150.0) 

z  :  dtau  0.00005*00  to  i.eeeeE*e0  (TicK*e.teee) 

Figure  58.  Example  of  Plot  2,  a  3-D  Plot  of  Differential  Transmittance  as  a 
Function  of  Layer  Number  and  Wavenumber,  for  a  Midlatitude  Winter  Atmosphere 
and  Viewing  Angles  of  -45°  and  1 1 .25° 
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Sljiu/Un: 


SMHRJUI7  GRAPHICS  t  HMYKI  MODULI 


PLOT  TYPE:  1)  RAW-XYZ  2)  ASM  RADIANCE  3)  DTAU  4)  BLACK  BODY  rOBCTION 


PLOT  TYPE?  [] 


Figure  59.  Example  of  the  Initial  Screen  for  SENTRAN7  Graph  and  Analyze 
Features  for  Tutorial  #2 
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6  PROTOTYPE  SENSITIVITY  PACKAGE  FOR  FASCODE3,  SENCODE 

In  a  parallel  effort,  a  “beta”  version  of  a  sensitivity  package  for  FASCOD35  has 
been  developed.  This  package,  which  is  not  part  of  SENTRAN7,  has  been  named 
SENCODE  (SENsitivity  analysis  for  fasCODE).  The  purpose  of  the  effort  was  to 
demonstrate  that  such  a  package  is  possible  and  to  provide  a  cornerstone  for  future 
work  and  upgrades.  Due  to  time  and  resource  constraints,  only  some  of  the  features 
of  SENTRAN7  have  been  included  in  SENCODE.  Also,  the  card  sequence  in  the 
Edit  Module  was  developed  before  FASCOD3’s  input  stream  was  finalized,  so 
some  new  options  in  FASCOD3  are  not  available  in  SENCODE,  such  as  the  cross 
section  feature.  This  chapter  briefly  describes  the  features  of  SENCODE,  although 
a  public  release  version  is  not  available.  Furthermore,  readers  are  reminded  that 
only  a  preliminary  version  of  FASCOD3,  FASCOD3P,  is  currently  available  and 
the  complete  Users  Guide  for  FASCOD3  has  not  yet  been  released.  Explanation 
of  the  FASCOD3  variables  and  card  options  discussed  below  is  available  only  as 
part  of  the  Users  instructions. 

6.1  Framework  of  SENCODE 

The  framework  for  SENCODE  is  analogous  to  SENTRAN7.  Users  are  able 
to  develop,  load,  save,  and  compile  methodology  files.  These  methodology  files 
are  not  compatible  with  SENTRAN7  methodology  files.  The  Run  Module  and  the 
Graph  and  Analyze  Module  in  SENTRAN7  are  not  included  in  the  beta  version 
of  SENCODE.  The  Run  Module  was  removed  because  FASCOD3  often  executes 
slowly,  which  defeats  the  purpose  of  an  on-line  run  feature.  Also,  a  well-conceived 
Run  Module  should  initially  confirm  that  a  user-supplied  TAPE3  linefile  covers  the 
frequency  interval  of  the  FASCOD3  calculation,  which  was  beyond  the  scope  of 
this  effort.  (The  TAPE3  linefile  contains  high  resolution  molecular  absorption 
data  used  by  FASCOD3.)  The  Graph  and  Analyze  Module  was  also  not  included. 
Specifically,  the  FASCOD3  output  file  scheme  is  far  more  complicated  than  the  out¬ 
put  generated  by  LOWTRAN7,  so  the  existing  Graph  and  Analyze  Module  would 
require  considerable  code  modification.  Additionally,  the  output  from  FASCOD3 
may  exceed  the  internal  plotting  capabilities  developed  for  SENTRAN7.  Effec¬ 
tively  then,  the  current  version  of  SENCODE  only  permits  users  to  perturb  certain 
input  parameters  and  then  set  up  an  input  file  for  multiple  runs  of  FASCOD3. 

6.2  Input  Restrictions 

The  SENCODE  Edit  Module  mimics  the  flow  through  the  FASCOD3  input  card 
images.  Given  the  complicated  nature  of  FASCOD3  input  cards,  this  can  be  an 
extremely  useful  tool  in  itself.  However,  the  FASCOD3  input  cards  are  far  more 
lengthy  than  LOWTRAN7  input  cards.  Therefore,  the  current  version  of  SEN- 
CODE  only  permits  input  parameters  on  some  cards  to  be  perturbed.  Table  17  lists 
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the  perturbation  options  available  in  SENCODE.  Some  of  these  restrictions  arise 
from  time  constraints  and,  hopefully,  can  be  relaxed  in  future  efforts.  Other  input 
parameters,  especially  on  Card  1.2,  cannot  be  perturbed  because  their  perturbation 
creates  different  flows  through  the  FASCOD3  input  card  images. 

Data  for  some  FASCOD3  input  cards,  such  as  the  trace  gas  profiles,  cannot 
be  entered  easily  within  SENCODE  because  they  involve  excessive  amounts  of 
terminal  input.  For  these  card  series,  data  are  read  from  external  files  with  default 
extensions.  These  files  must  be  created  off-line  by  the  user.  For  reference.  Table  18 
gives  the  card  series  read  from  external  files  and  their  default  extensions.  The 
format  of  the  external  files  should  match  the  format  of  the  FASCOD3  input  cards 
that  they  are  meant  to  represent.  As  part  of  the  initial  testing  of  SENCODE,  the 
code  was  able  to  read  sample  external  files  for  each  long  card  series  and  then  create 
“readable”  input  cards  for  FASCOD3. 

6.3  Additional  Comments 

A  fair  amount  of  time  was  spent  insuring  that  SENCODE  properly  creates 
input  card  images  for  FASCOD3.  To  do  this,  numerous  FASCOD3  options  were 
exercised  via  SENCODE’s  Edit  and  Compile  Modules.  In  all  cases,  FASCOD3 
was  able  to  read  the  input  file  created  by  SENCODE,  and  produce  (what  appears  to 
be)  meaningful  output  in  TAPE6.DAT.  However,  SENCODE  should  not  be  viewed 
as  an  interface  for  producing  crash-proof  FASCOD3  runs.  Users  can  go  astray  in 
their  analyses  because: 

1.  Meaningful  limits  on  some  input  parameters  depend  on  the  precise  path 
geometry,  which  is  difficult  to  check  for. 

2.  For  some  input  parameters,  only  FASCOD3  can  determine  if  the  specified 
value  is  “proper”.  FASCOD3  users  often  have  to  ran  the  code  a  few  times 
to  make  sure  everything  is  okay,  especially  for  the  atmospheric  layering. 

3.  Some  variable  names,  such  as  NPTS,  appear  on  more  than  one  input  card, 
but  take  on  different  meanings. 

4.  Input  parameters  on  some  FASCOD3  cards  are  inheritly  related  to  those 
on  other  cards.  SENCODE  performs  limited  checking  between  cards  for 
internal  consistency. 

Thus,  it’s  quite  possible  that  SENCODE  users  can  cause  FASCOD3  to  bomb  during 
execution.  The  point  here  is  that  users  still  need  to  know  a  great  deal  about 
FASCOD3  when  using  SENCODE. 
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Table  17.  Perturbation  Options  in  the  Beta  Version  of  SENCODE.  Recall  that 
SENCODE  was  developed  from  a  more  preliminary  version  of  FASCOD3P,  so 
some  FASCOD3  options  are  not  available  and  some  card  numbers  may  need  to  be 
updated 


CARD 

PERTURBATION 

NUMBER 

PERMITTED 

COMMENT 

1.1 

No 

Character  data 

1.2 

No 

1.2.1 

No 

1.3 

No 

1.4 

No 

1.5 

No 

1.5.1 

No 

1.5.2 

No 

1.5.3 

No 

2.1 

Yes 

MODEL  parameter  only 

2.2  (ITYPE=1) 

Yes 

2.2  (ITYPE=2,3) 

Yes 

All  parameters  except  LEN 

2.3A 

Yes 

2.3B 

No 

2.4 

No 

Not  meaningful  to  perturb 

2.5 

Yes 

Percent  perturbations  only 

2.6.1  ..  2.6.N 

Yes 

Percent  perturbations  only 

3.1 

Yes 

Some  restrictions  on  IHAZE,  ICLD,  I  VS  A 

3.2 

Yes 

3.3 

Yes 

3.4 

No 

Character  data 

3.5.1  ..  3.5.N 

Yes 

3.6 

Yes 

4.1  ..  4.N 

Yes 

Nominal  value  must  equal  VI  on  CARD  1.3 

5 

No 

6.1 

No 

6.2 

No 

6.3  ..  6.N 

No 

7.1 

No 

Only  one  7.1  is  permitted 

8.1 

No 

Only  one  8.1  is  permitted 

9.1 

No 

Only  one  9. 1  is  permitted 

9.2 

No 

9.3  ..  9.N 

No 

10.1 

No 

Not  available  in  SENCODE 
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Table  18.  External  Data  Files  Used  By  the  Beta  Version  of  SENCODE  to  Represent 
Long  FASCODE  Card  Series 


CARD 

SERIES 

FILE 

EXTENSION 

CONTENTS 

1.5 

1.5.1 

1.5.2 

1.5.3 

LAY 

Layer  input  data  for  molecules 
i.e.,  column  densities 

2.3B 

JBMX 

Altitudes  for  FSCATM  layer  boundaries 

2.4 

2.5 

2.6.1  ..  2.6.N 

J>RO 

User  defined  atmospheric  profiles 

3.4,  3.5.1  ..  3.5.N 

HAZ 

Aerosol  or  cloud  profiles 

AER 

Aerosol  wavelength  scaling  factors 

6.2,  6.3  ..  6.N 
and 

9.2,  9.3  ..  9.N 

FLT 

Filter  function  data 

7  SUMMARY  AND  RECOMMENDATIONS  FOR  FUTURE  STUDIES 


7.1  Summary 

The  main  thrust  of  this  effort  was  to  upgrade  the  original  SENTRAN  code 
for  use  with  LOWTRAN7.  The  new  sensitivity  analysis  package  has  been  named 
SENTRAN7.  SENTRAN7  contains  all  of  the  features  of  the  original  SENTRAN 
code  including: 

1.  Interactive  entry  of  LOWTRAN7  input  parameters  and  directives  for  their 
perturbations. 

2.  Intelligent  generation  of  LOWTRAN7  input  card  images. 

3.  Autonomous  post-processing  of  LOWTRAN7  outputs  for  data  extraction, 
analysis  and  graphical  display. 

4.  An  on-line  help  utility. 

Additionally,  a  number  of  new  features  are  available  in  SENTRAN7  such  as: 

1.  Compatibility  with  the  moderate  resolution  code  MODTRAN. 

2.  An  on-line  run  feature  for  LOWTRAN7  and  MODTRAN. 

3.  Screen  display  of  available  methodology  and  other  input  files. 

4.  Safeguards  to  prevent  existing  files  from  being  overwritten. 

5.  Increased  portability  across  hardware  platforms. 

6.  An  on-line  help  feature  within  the  Edit  Module. 

7.  Tick  marks  on  plots. 

8.  A  plot  option  for  trace  gas  profiles. 

In  a  parallel  effort,  a  beta  version  of  a  sensitivity  package  for  FASCOD3  was 
developed  and  named  SENCODE.  Although  this  package  is  not  available  for  public 
release,  initial  testing  suggests  that  the  full  development  of  such  a  package  is 
possible. 

7.2  Recommendations  for  Future  Studies 
7.2.1  Future  Work  on  SENTRAN7 

The  current  version  of  SENTRAN7  can  adequately  serve  as  a  sensitivity  anal¬ 
ysis  tool  for  LOWTRAN7  and  MODTRAN,  but  a  number  of  enhancements  to  the 
program  are  possible.  These  changes  would  provide  users  with  an  improved  user 
interface  system  and  additional  analysis  capabilities.  Some  of  the  action  items 
should  include 

1.  Developing  routines  that  check  user-defined  atmospheres  (Card  2C  series) 
for  physical  consistency,  especially  when  pressure,  temperature,  and/or  wa¬ 
ter  vapor  are  perturbed. 
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2.  Developing  a  procedure  for  specifying  random  or  uncorrelated  perturbations 
from  layer  to  layer  in  the  atmosphere. 

3.  Providing  additional  help  information  in  the  Edit  Module  to  inform  users 
which  LOWTRAN7  input  parameters  are  required  for  a  given  problem. 

4.  Providing  warning  messages  of  illegal  perturbation  values,  such  as  %900  for 
temperature,  upon  data  entry.  Currently,  erroneous  values  are  only  rejected 
during  compilation. 

5.  Adding  the  capability  to  determine  the  numerical  values  at  various  locations 
on  SENTRAN7  plots. 

6.  Extend  the  analysis  capabilities,  such  as  curve  fitting  and  mathematical 
manipulation  ( e.g .,  linear  operations)  of  the  LOWTRAN7  output  data. 

Finally,  SENTRAN7  should  be  made  available  to  more  researchers  in  the  scientific 
community  so  they  can  provide  constructive  feedback.  That  is,  improvements  to 
SENTRAN7,  especially  in  the  Graph  and  Analyze  Module,  should  be  designed  to 
satisfy  the  needs  of  the  maximum  number  of  prospective  users. 

7.2.2  Future  Work  on  SENCODE 

The  beta  version  of  SENCODE  is  incomplete  and  additional  work  must  be 
performed  on  it.  The  goal  of  future  studies  should  be  to  get  SENCODE  to  the  point 
where  it  performs  like  SENTRAN7.  Specifically,  future  studies  should  include  the 
following  items: 

1.  Making  SENCODE  compatible  with  all  FASCOD3  options. 

2.  Adding  an  on-line  help  option  in  the  Edit  Module. 

3.  Providing  a  Graph  and  Analyze  Module  for  viewing  FASCOD3  sensitivity 
analyses. 

The  last  item  is  a  formidable  task  because  it  involves  reading  FASCOD3  output 
files.  For  simplicity,  the  Graph  and  Analyze  Module  should  initially  be  able  to 
interpret  the  laser  line  option  because  these  results  are  always  written  to  FAS- 
COD3’s  TAPE6  file  as  formatted  output.  To  interpret  standard  FASCOD3  output, 
one  possible  route  is  through  FASCOD3’s  internal  plot  option.  Specifically,  the  in¬ 
put  parameter  JOUT  on  Card  10.3A  can  be  hard-wired  such  that  FASCOD3  writes 
plot  values  to  a  file  as  formatted  output.  In  turn,  these  formatted  files  could  be  read 
by  SENCODE  using  routines  like  those  that  read  tape7  and  tape8  in  SENTRAN7. 
Because  many  types  of  plots  can  be  generated  by  FASCOD3  (i.e.,  transmittance, 
radiance),  a  major  part  of  developing  a  Graph  and  Analyze  Module  will  be  to: 

1.  Generate  a  sequence  of  prompts  that  ask  users  what  they  want  to  graph  and 
analyze,  based  on  the  problem  they  specified 
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2.  Get  SENCODE  to  read  FASCOD3  output  files  and  then  plot  the  quantity 
( i.e optical  depth,  transmittance  or  radiance)  requested  by  the  user. 
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Appendix  A 
File  Structure 

There  are  several  types  of  files  associated  with  the  SENTRAN7/LOWTRAN7 
system.  Table  A-l  contains  the  file  types  and  their  default  extensions  along  with 
which  program  produces  which  files.  The  length  of  a  file  name  is  restricted  to 
20  characters.  If  the  user  enters  a  file  name  containing  more  than  20  characters, 
SENTRAN7  will  truncate  the  file  name  to  the  first  20  characters.  The  structure 
and  use  of  each  type  of  file  is  discussed  in  detail  here. 

Table  A-l.  Default  File  Names  Associated  With  SENTRAN7 


FILE  NAME 

AND  EXTENSION 

ORIGIN 

CONTENTS 

*MTH 

SENTRAN7 

Methodology  files 

*JNP 

SENTRAN7 

LOWTRAN7/MODTRAN  input  files 

+J>RO 

User 

Model  atmosphere  data  {i.e..  Card  2C  series) 

*AER 

User 

Aerosol  extinction  coefficients  {i.e..  Card  2D  series) 

*J>HS 

User 

Aerosol  phase  functions  {i.e„  Card  3B  series) 

*.OUT 

LOWTRAN7/MOD7RAN 

Output  data  used  for  plotting 

*JD 

User/SENTRAN7 

Raw  x,y,  z  data 

*.TEK 

SENTRAN7 

Tektronix  graphics  files 

*.COS 

SENTRAN7 

Cosmetic  data 

SEN. ERR 

SENTRAN7 

Error  log  and  major  absorber  information 

SENLOG 

SENTRAN7 

User  input  log 

*  Denotes  a  generic  character  string 


A.l  Methodology  File 

Methodology  files  contain  information  necessary  for  setting  the  parameters  in 
the  Edit  Module  to  specific  values,  including  both  nominal  values  and  perturbation 
directives.  They  provide  a  convenient  means  for  saving  input  data  for  LOWTRAN7 
experiments  for  later  recall.  Methodology  files  are  generally  written  and  read  via 
the  Load/Save  Module,  with  the  exception  of  a  special  file  called  LAST.MTH.  The 
file,  LAST.MTH ,  is  saved  after  every  completed  editing  session  (i.e.,  an  editing  ses¬ 
sion  in  which  the  user  does  not  proceed  to  the  Main  Menu  via  the  END  command) 
and  every  compilation.  This  file  is  loaded  every  time  that  SENTRAN7  is  started. 
Since  SENTRAN7  extracts  vital  information  from  this  file,  the  user  is  cautioned 
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against  tampering  with  it  in  any  way.  Methodology  files  have  default  extensions 
of  MTH. 

A.2  Input  File 

Input  files  are  files  containing  the  LOWTRAN7  or  MODTRAN  input  parame¬ 
ters.  Input  files  are  generated  by  SENTRAN7’s  Compile  Module.  They  are  given 
the  default  extension  of  JNP. 

A .3  Model  Atmosphere  Data  File 

Model  atmosphere  data  files  have  .PRO  default  extensions  and  represent  the 
Card  2C  series  in  LOWTRAN7.  Data  in  this  input  stream  include  layer-by-layer 
profiles  of  temperature,  water  vapor,  trace  gases  and  aerosol  extinction.  Details 
about  variable  definitions  and  record  formats  can  be  found  in  the  manual  for 
LOWTRAN71. 

Because  the  Card  2C  series  usually  involves  many  input  records,  the  .PRO 
files  must  be  created  off-line  by  the  user.  However,  the  SENTRAN7  package 
does  include  six  .PRO  files  which  represent  the  six  model  atmospheres  in  LOW- 
TRAN7.  Temperature,  water  vapor  and  trace  gas  amounts  in  these  files  were  taken 
directly  from  the  LOWTRAN7  databases.  The  aerosol  extinction  profiles  represent 
a  23  km  surface  visibility  in  the  boundary  layer  and  background  values  in  the  free 
troposphere,  stratosphere  and  upper  atmosphere. 

The  .PRO  files  included  with  the  SENTRAN7  package  can  be  used  to  do 
sensitivity  studies  for  the  standard  LOWTRAN7  model  atmospheres.  To  do  this,  the 
user  must  first  set  the  MODEL  parameter  on  Card  1  equal  to  0  or  7.  When  the  Edit 
Module  asks  for  a  filename  for  the  Card  2C  series,  the  user  then  enters  ‘modell’, 
‘model2\  etc.  After  a  filename  is  specified,  the  next  screen  contains  a  list  of 
input  parameters  for  Card  2C  where  users  can  assign  their  percent  perturbations. 
Additionally,  novice  users  can  use  the  model  .PRO  files  as  guides  to  create  and 
debug  their  own  atmosphere  profiles.  Note  that  if  aerosol  extinction  profiles  are 
included  in  a  .PRO  file,  they  will  override  the  values  of  other  aerosol  parameters 
on  Card  2. 

A.4  Aerosol  Extinction  Coefficients  Data  File 

Files  with  .AER  extensions  represent  the  Card  2D  series  in  LOWTRAN7.  Data 
in  this  input  stream  include  conversion  factors  from  equivalent  water  content  to 
aerosol/cloud  extinction  coefficient  and  values  of  aerosol/cloud  extinction,  absorp¬ 
tion  and  asymmetry  parameter  versus  wavelength  for  up  to  four  altitude  regions. 
Details  about  variable  definitions  and  record  formats  can  be  found  in  the  manual 
for  LOWTRAN7.1 

The  .AER  files  must  be  created  off-line  by  the  user  because  the  Card  2D  se¬ 
ries  typically  involves  many  input  records.  However,  the  SENTRAN7  package 
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does  contain  a  file  named  SAMPLE. AER  which  can  be  used  by  novice  users  as  a 
guide  to  create  and  debug  their  own  aerosol  files.  The  file,  SAMPLEAER,  con¬ 
tains  wavelength  scaling  factors  for  standard  aerosols  in  four  altitude  regions:  (1) 
rural  aerosol  at  70%  humidity  in  the  boundary  layer;  (2)  tropospheric  aerosol  at 
70%  humidity  in  the  free  troposphere;  (3)  background  stratospheric  aerosol  for  the 
stratosphere;  and  (4)  meteoric  dust  in  the  upper  atmosphere. 

The  SAMPLEAER  file  with  the  SENTRAN7  package  can  be  used  to  do  sen¬ 
sitivity  studies  for  aerosol  and  cloud  scattering  as  a  function  of  wavelength.  To 
do  this,  the  user  must  first  either  set  the  IHAZE  parameter  on  Card  2  equal  to  7 
or  the  ICLD  parameter  on  Card  2  equal  to  11.  When  the  Edit  Module  asks  for 
a  filename  for  the  Card  2D  series,  the  user  can  enter  ‘sample’  or  the  name  of 
another  AER  file  that  they  have  created.  After  a  filename  is  specified,  the  next 
screen  contains  a  list  of  input  parameters  for  Card  2D  where  users  can  assign  their 
percent  perturbations.  Note  that  the  Edit  Module  will  scan  the  contents  of  the  input 
AER  file  and  only  display  input  parameters  for  the  altitude  regions  where  data  are 
provided. 

A.5  Aerosol  Phase  Functions  Data  File 

Files  with  .PHS  extensions  represent  the  Card  3B  series  in  LOWTRAN7.  Data 
in  this  input  stream  are  phase  functions  for  aerosol  scattering.  Details  about  variable 
definitions  and  record  formats  can  be  found  in  the  manual  for  LOWTRAN7.1 

Because  the  Card  3B  series  usually  inv loves  many  input  records,  the  .PHS 
files  must  be  created  off-line  by  the  user.  However,  the  SENTRAN7  package 
does  include  a  file  called  SAMPLE.PHS  which  can  be  used  by  novice  users  as 
a  guide  to  create  and  debug  their  own  phase  function  files.  For  reference,  the 
SAMPLE.PHS  file  contains  the  phase  function  of  a  rural  aerosol  at  70%  humidity 
and  at  a  wavelength  of  0.55  //m. 

The  SAMPLE.PHS  file  with  the  SENTRAN7  package  can  be  used  as  part  of 
sensitivity  studies  for  aerosol  and  cloud  scattering.  To  do  this,  the  user  must  first 
set  the  IPH  parameter  on  Card  3A1  equal  to  2.  When  the  Edit  Module  asks  for  a 
filename  for  the  Card  3B  series,  the  user  can  type  ‘sample’  or  the  name  of  another 
.PHS  file  that  they  have  created.  The  Edit  Module  will  read  the  input  .PHS  file, 
and  the  phase  function  will  be  included  in  the  LOWTR AN7  input  cards.  Howe’  er, 
the  current  version  of  SENTRAN7  does  not  allow  users  to  perturb  values  in  the 
.PHS  file. 
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A.6  Output  Files 

The  output  files,  tape7  and  tape8,  contain  LOWTRAN7  or  MODTRAN  gener¬ 
ated  data.  The  information  in  these  two  files  are  copied  to  the  files,  TAPE7.0UT 
and  TAPE8.0UT ,  respectively,  in  a  format  which  SENTRAN7  can  use  to  extract 
data  for  graphical  analysis.  The  contents  of  these  files  depend  on  the  values  of 
IEMSCT,  IMULT  and  NOPRT  on  Card  1.  Details  about  the  contents  of  these 
output  files  and  record  formats  can  be  found  in  the  manual  for  LOWTRAN7.1 

A.7  3-D  Files 

Three  dimsenional  files  are  files  in  raw  x ,  y ,  c  format.  Z  must  be  a  single  valued 
function  of  x  and  y,  while  x  and  y  must  form  a  semi-regular  mesh.  That  is,  the 
(x,y)  data  should  form  a  rectangular  grid  with  a  z  value  present  for  every  possible 
( x,y )  combination,  but  the  spacing  of  the  x  and  y  points  need  not  be  uniform.  These 
files  can  be  written  to  disk  from  within  the  G&A  Module  of  SENTRAN7.  It  is 
worth  noting  that  SENTRAN7  can  read  any  file  in  x,  y ,  r  format  which  conforms 
to  the  specifications  above.  Thus  SENTRAN7’s  graphing  and  analysis  capabilities 
are  not  limited  to  LOWTRAN7  and  MODTRAN  data.  Another  fact  worth  noting 
is  that  3D  files  are  free  of  cosmetic  data,  and  are  easily  exported  to  more  powerful 
graphics  and  analysis  systems. 

A.8  Graphics  File 

Graphics  files  consist  of  special  escape  sequences  and  character  data,  that  are 
interpreted  by  Tektronix  4010/4014  compatible  devices  in  order  to  generate  hard 
copy  output  of  SENTRAN7  plots.  These  files  are  given  a  default  extension  of 
.TEK.  A  wide  variety  of  devices  can  interpret  TEK  files,  either  by  design  or  via 
special  translating  programs.  Devices  supported  include  video  terminals,  laser 
printers,  thermal  plotters,  pen  plotters  and  dot  matrix  printers.  Thus  TEK  files 
offer  a  convenient  means  of  storing  and  exchanging  graphical  representations  of 
data. 

A.9  Cosmetic  File 

Cosmetic  files  contain  “cosmetic”  information  for  3D  files.  These  cosmetic  files 
are  actually  screendumps  of  the  G&A  command  screen,  providing  information  on 
the  data  source  file,  any  numerical  manipulations  which  have  been  performed,  the 
most  recent  raw  j,  y,  c  file  ( *  JD )  generated,  if  any,  and  the  most  recent  graphics 
file  ( *.TEK)  generated,  among  other  pieces  of  information. 

\.10  SEN.ERR  File 

The  SEN.ERR  file  is  devoted  to  debugging  and  temporary  storage  of  information 
on  major  absorbers.  If  the  user  compiles  an  input  file  with  the  /ERROR  option, 
SENTRAN7  writes  all  compile  time  errors  to  SEN.ERR  along  with  the  names 
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of  major  absorbing  species  and  their  intervals  of  activity  in  the  current  spectral 
interval. 

A.ll  SEN. LOG  File 

The  SEN.LOG  file  is  a  product  of  SENTRAN7’s  logging  function.  This  func¬ 
tion  permits  the  user  to  maintain  a  terse  log  of  his/her  SENTRAN7  sessions.  SEN- 
TRAN7  automatically  adds  comments,  which  aid  in  determining  the  logical  flow 
that  was  taken  through  the  program.  The  user  can  replace  these  automatic  com¬ 
ments  with  comments  of  his/her  own.  Comments  consist  of  all  text  within  the 
input  string  following  an  apostrophe.  For  example  in  the  string,  edit  ’invoke  ed¬ 
itor  function,  “invoke  editor  function”  is  a  comment  and  will  be  ignored  by  the 
program. 

Using  a  verbose  style  in  entering  commands  will  also  enhance  readability  of 
SEN.LOG  files.  For  example  the  following  commands,  when  typed  at  the  main 
menu  will  yield  identical  results: 

3  test/m/e 

compile  test.inp  /mesh/error 

Clearly,  the  second  style  is  much  more  readable,  and  is  the  preferred  style  when 
developing  a  SEN.LOG  file.  These  tools  are  indispensible  for  developing  and 
debugging  input  files  for  batch  submissions  of  SENTRAN7. 

A.12  Help  File 

Another  file  included  with  the  SENTRAN7  package  is  a  help  file,  SEN- 
TRAN.HLP.  SENTRAN7  uses  this  file  internally  in  order  to  generate  its  help 
screens.  The  user  is  cautioned  against  tampering  with  this  help  file. 
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Appendix  B 

Code  Changes  to  LOWTRAN7  and  MODTRAN 

As  noted  in  Section  3.3,  LOWTRAN7  and  MODTRAN  have  been  modified 
slightly  in  order  to  run  with  SENTRAN7.  These  changes  have  already  been  made 
in  the  LOWTRAN7  and  MODTRAN  source  codes  provided  with  this  distribution 
{lowtran7  for  and  modtran.for,  respectively).  The  changes  made  are  outlined  here 
only  for  reference. 

Figure  B-l  shows  the  changes  made  to  the  subroutine  TRANS  in  lowtran7.for. 
Line  numbers  8020-8060  and  8180-8210  have  been  commented  out.  These  lines 
are  indicated  with  a  ‘c!’  comment  symbol  in  Figure  B-l. 

Figure  B-2  shows  the  changes  made  to  the  subroutine  TRANS  in  modtran.for. 
Line  numbers  7350-7390  and  7530-7570  have  been  commented  out.  These  lines 
are  indicated  with  a  ‘c!’  comment  symbol  in  Figure  B-2.  In  addition,  because 
the  input  structure  for  MODTRAN  is  slightly  different  from  LOWTRAN7,  the 
subroutines  BMDATA  and  DRIVER  in  modtran.for  were  modified  slightly  so  that 
MODTRAN  could  be  run  from  SENTRAN7.  The  changes  made  to  subroutines 
BMDATA  and  DRIVER  are  shown  in  Figures  B-3  and  B-4,  respectively.  In  the 
subroutine  BMDATA,  lines  of  code  have  been  added  and/or  modified  between  line 
numbers  270  and  290.  In  the  subroutine  DRIVER,  lines  of  code  have  been  added 
and/or  modified  between  line  numbers  1090  and  1120  and  between  line  numbers 
3780  and  3800. 
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SUBROUTINE  TRANS 


c 

TRA  7860 

c 

FOR  SO  MULTIPLE  SCATTERING,  CALCULATE  BLACK  BODY  FUNCTION, 

TRA  7860 

c 

AS  WELL  AS  RADIANCE  ADDING  FOR  THERMAL 

TRA  7870 

c 

TRA  7880 

BBIK=BBFN(TBBY(IK),V) 

TRA  7890 

c 

TLNEW=(TX(9)*TX(10) )/ (TX(7) *TX(6) ) 

TRA  7900 

c 

TSNEW=(TX(7)*TX(6) )/TX( 10) 

TRA  7910 

TLNEW=  TX(9) 

TRA  7920 

DTAU=TLOLD-TLNEW 

TRA  7930 

IF(IMULT.EQ.l)  DTAU  =  TOTAL  -  TX(9) 

TRA  7940 

TOTAL  =  TX(9) 

TRA  7960 

IF(DTAU.LE.O. )  DTAU=0. 

TRA  7960 

IF(IMULT  .EQ.  0)  THEN 

TRA  7970 

IFCNOPRNT.  EQ.  -1)  THEN 

TRA  7980 

WRITE(IPR1 , 1210)  V.AHT(IK) ,AHT(IK+1) ,BBIK,DTAU,TLHEW 

TRA  7990 

1210  F0RMATCF10 . 0 , 2F7 . 2 , 1P2E12 . 5 , 0PF12 . 9) 

TRA  8000 

ENDIF 

TRA  8010 

C 

»»  CODE  MODIFIED  BY  SPARTA  FOR  SENTRAN7  <«< 

c! 

IF  (DTAU. LT. 1.0E-6.AND.TLNEW.LT. 1.0E-6)  THEN 

TRA  8020 

c! 

IFCNOPRNT.  EQ.  -1)  WRITECIPR1 , 1220) 

TRA  8030 

c! 

1220  FORMAT ( 1  -999.',T63,’  DTAU  EXIT  LOOP  ’) 

TRA  8040 

c! 

GO  TO  220 

TRA  8060 

c ! 

ENDIF 

TRA  8060 

c 

»»  END  MODIFICATIONS  «« 

SUMV=SUMV+BBIK*DTAU 

TRA  8070 

c 

RADIANCE  /  CONSERVATIVE  SCATTERING 

TRA  8080 

ELSE 

TRA  8090 

IF(INIT.EQ.O)  GO  TO  210 

TRA  8100 

N1  =  ML  -  IMAP(IK)  +  IOFF 

TRA  8110 

IF(N1 . GE.ML  )  N1  =  ML  -  1 

TRA*8122 

IFCNOPRNT.  EQ.  -1)  THEN 

TRA  8130 

N  =  N1  +  1 

TRA  8140 

WRITECIPR1 , 1230)  V, AHTCIK+1) ,UMB(N) ,UMBS(N) ,DMB(N) , 

TRA  8160 

X  DMBS(N) ,SUH*TX(9) ,TX(9) 

TRA  8160 

ENDIF 

TRA  8170 

c 

»»  CODE  MODIFIED  BY  SPARTA  FOR  SENTRAN7  «« 

c! 

IF  (DTAU. LT.1.0E-6. AND. TX(9).LT.1.0E-6)  THEN 

TRA  8180 

c! 

IFCNOPRNT.  Eq.  -1)  WRITEClPRl , 1220) 

TRA  8190 

c! 

GO  TO  220 

TRA  8200 

c! 

ENDIF 

TRA  8210 

C 

»»  END  MODIFICATIONS  «« 

Figure  B-l.  Code  Changes  to  the  Subroutine  TRANS  in  LOWTRAN7  For  Use 
with  SENTRAN7 
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SUBROUTINE  TRANS 


c 

TRA  7200 

c 

FOR  HQ 

MULTIPLE  SCATTERIHG,  CALCULATE  BLACK  BODY  FUHCTIOI. 

TRA  7210 

c 

AS  WELL  AS  RADIAICE  ADDIIG  FOR  THERMAL 

TRA  7220 

c 

TRA  7230 

BBIK=BBFH(TBBY ( IKOFF) , V ) 

TRA  7240 

TLIEW=TX(9) 

TRA  7260 

DTAU=TLOLD-TLHEW 

TRA  7280 

IF ( IMULT .  EQ .  1 ) DTAU=TOTAL-TX ( 9 ) 

TRA  7270 

T0TAL=TX(9) 

TRA  7280 

IF(DTAU.LE.O. )DTAU=0. 

TRA  7290 

IF ( IMULT. EQ.O) THEM 

TRA  7300 

IF(HOPRIT . EQ . - 1 ) THEM 

TRA  7310 

WRITECIPR1 , ’ (F10 . 0 , 2F7 . 2 , 1P2E12 . 5 ,0PF12 . 9) ' ) 

TRA  7320 

1 

V, AHT(IK) ,AHT(IK+1) , BBIK, DTAU , TLIEW 

TRA  7330 

EHDIF 

TRA  7340 

c 

>»> 

CODE  MODIFIED  BY  SPARTA  FOR  SEHTRAH7  «« 

c! 

IF (DTAU . LT . 1 . E-6  . AND .  TLHEW . LT . 1 . E-6)THEH 

TRA  7360 

c! 

IF(HOPRHT.EQ.-l) 

TRA  7360 

c! 

1 

URITE(IPR1 , ’ (5X , 5H-999 . ,T65 , 16HDTAU  EXIT  LOOP)' 

)  TRA  7370 

c! 

G0T0200 

TRA  7380 

c! 

EHDIF 

TRA  7390 

C 

>»> 

EHD  MODIFICATIOHS  «« 

SUMV=SUMV+BBIK*DTAU 

TRA  7400 

C 

TRA  7410 

C 

RADIAHCE  /  COHSERVATIVE  SCATTERIHG 

TRA  7420 

C 

TRA  7430 

ELSE 

TRA  7440 

IF(IHIT.EQ.0)G0T0190 

TRA  7460 

H1=HL-IMAP(IK)+I0FF 

TRA  7460 

C 

*** 

TRA*7466 

CC 

IF(H1 . GE.ML)G0T0190 

TRA*7470 

IF(I1 . GE.HL)H1  =  ML  -  1 

TRA*7472 

C 

*** 

TRA*7474 

IF (HOPRHT . EQ . - 1 ) T8EH 

TRA  7480 

H=H1+1 

TRA  7490 

WRITE(IPR1 , 1 (F10 .0 ,F7 . 2 , 1P6E12 . 5 ,0PF10. 6) * )V , AHT(IK+1)TRA  7600 

1 

,UMB(H) ,UMBS(H) ,DMB(H) ,DMBS(H) ,SUH*TX(9) ,T*(8) 

TRA  7610 

EHDIF 

TRA  7620 

C 

»» 

CODE  MODIFIED  BY  SPARTA  FOR  SEHTRAH7  «« 

c ! 

IFCDTAU.LT. l.E-6  . AMD .  TX(9) .LT.l. E-6) THEM 

TRA  7530 

c! 

IF ( HOPRHT. EQ . -1 ) 

TRA  7640 

c! 

1 

WRITE (IPR1 , ’ (5X , SH-999 . ,T66 , 16HDTAU  EXIT  LOOP) 

’)  TRA  7660 

c ! 

G0T0200 

TRA  7560 

c! 

EHDIF 

TRA  7670 

c 

»» 

EHD  MODIFICATIOHS  «« 

Figure  B-2.  Code  Changes  to  the  Subroutine  TRANS  in  MODTRAN  For  Use  with 
SENTRAN7 


SUBROUTINE  BMDATA 


c  BMD  270 

C  »»  CODE  MODIFIED  BY  SPARTA  FOR  SENTRAN7  «« 

CHARACTER*80  DIRUF 

0PEN(UNIT=60 , FILE= ’ MODTRAN . RUM ’ , STATUS5  *  OLD ’ ) 

READ (60, ’(LI)') NODTRK 
READ(60 , ’ ( A80) ' )DIRUF 
CLOSE (UMIT=60) 

ITB  5  9  XXX 

OPEH(ITB,FILE=DIRUF,STATUS=,OLD, ,FORM= 'UNFORMATTED')  BMDXXX80 

C  »»  END  MODIFICATIONS  «« 

10  REWIND (ITB)  BMD  290 


Figure  B-3.  Code  Changes  to  the  Subroutine  BMDATA  in  MODTRAN  For  Use 
with  SENTRAN7 


SUBROUTINE  DRIVER 


C  1  M4 , MS , M6 , MDEF , IM , NOPRT , TBOUND , S ALB  DRV  1090 

C  »»  CODE  MODIFIED  BY  SPARTA  FOR  SENTRAN7  «« 

0PEH(UHIT=60 , FILE= ’ MODTRAN . RUN ' , STATUS5 'OLD ’ ) 

READ(60 , ’ (LI) ' )MODTRN 
CL0SE(UIIT=60) 

READ(IRD, ’ (16, 12IS,F8.3,F7.2) ’) MODEL, ITYPE.IEMSCT,  DRV  1100 

1  IMULT , M 1 , M2 , M3 , M4 , MS , M8 , MDEF , IM , NOPRT , TBOUND , S ALB  DRV  1110 

C  »»  END  MODIFICATIONS  «« 

1110  FORMAT( 13IS ,F8 . 3,F7 . 2)  DRV  1120 

C1401  F0RMAT('0  CARD  4  ****** ,3F10. 3)  DRV  3780 

C  »»  MODIFICATIONS  BY  SPARTA  FOR  SEITRAN7  «« 

READ(IRD, '(3F10.3,I10)*)RV1,RV2,RDV,IFVHM  DRV  3790 

IV1=INT(RV1) 

IV2-IHT(RV2) 

IDV=IIT(RDV) 

C  »»  END  MODIFICATIONS  «« 

401  WRITEdPR. ’(1S80  CARD  4  *****,4110) ’)IV1,IV2,IDV,IFWHM  DRV  3800 


Figure  B-4.  Code  Changes  to  the  Subroutine  DRIVER  in  MODTRAN  For  Use 
with  SENTRAN7 
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Appendix  C 

Quick  Reference  Guide  For  SENTRAN7 

There  are  many  commands  and  files  associated  with  the  SENTRAN7  package. 
Therefore,  this  appendix  serves  as  a  quick  reference  guide  to  help  users  become 
familiar  with  operating  SENTRAN7.  Effectively,  the  guide  is  a  collection  of  tables 
that  were  previously  introduced  in  the  main  text.  The  material  is  not  formally 
organized;  rather,  it  is  designed  to  give  users  quick  and  concise  information  about 
the  commands  and  features  of  SENTRAN7.  Table  C-l  lists  the  cursor  control 
commands  used  in  the  Edit  Module.  Table  C-2  lists  the  perturbation  commands 
used  in  the  Edit  Module.  Table  C-3  lists  examples  of  perturbation  commands  that 
can  be  used.  Table  C-4  lists  the  allowable  compiler  commands  as  typed  from  the 
Main  Menu  and  Table  C-5  lists  examples  of  these  compiler  commands  as  they 
would  be  typed  from  the  Main  Menu. 

Table  C-6  to  C-9  relate  the  Graph  and  Analyze  Module.  Table  C-6  provides 
the  list  of  the  types  of  plots  that  are  available  in  the  Graph  and  Analyze  Module, 
while  Table  C-l  lists  the  commands  that  are  used  to  perform  numerical  analysis 
in  the  Graph  and  Analyze  Module.  Table  C-8  lists  the  plotting  commands  used 
while  in  the  Graph  and  Analyze  Module  and  Table  C-9  lists  the  commands  used 
for  input/output  and  control  operations  in  the  in  the  Graph  and  Analyze  Module. 

Tables  C-10  and  C-ll  relate  to  the  files  used  and  provided  with  SENTRAN7. 
Table  C-10  lists  the  default  file  names  and  extensions  used  with  SENTRAN7  and 
Table  C-ll  is  a  checklist  of  the  files  provided  with  the  SENTRAN7  package. 
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Table  C-l.  List  of  Cursor  Control  Commands  in  the  Edit  Module  of  SENTRAN7 


COMMAND 

ACTION 

UP  n1 

Move  cursor  up  n  lines 

DN  n 

Move  cursor  down  n  lines 

PU 

Move  to  previous  major2  card  image 

PD 

Move  to  next  major  card  image 

END 

End  editing  session,  goto  main  menu 

1  n  is  optional;  its  absence  means  n  =  1 

2  Major  cards  are  Card  1,  2,  3,  4 


Table  C-2.  List  of  Perturbation  Command  Syntaxes  in  the  Edit  Module 


TYPE  OF 

PERTURBATION 

SYNTAX  FORMAT 

%l 

nominal  value  %value 

+/- 

nominal  value  +/-  value 

Iteration 

nominal  value  [start]2  TO  final  [STEP  n] 

List 

nominal  value  value 2  value3  ... 

Use  Previous 

nominal  value  * 

1  On  Card  2C  and  2D,  no  nominal  value  allowed  with  percent  perturbation 

2  Terms  in  “[  ]”  are  optional 

Table  C-3.  Examples  of  Perturbation  Directives 


SAMPLE 

PARAMETER 

PERTUBATION 

DIRECTIVE 

SEQUENCE 

PRODUCED 

HI 

5.0  %20 

4.0,  5.0,  6.0 

H2 

8.0  +/-  2 

6.0,  8.0,  10.0 

ANGLE 

45.0  TO  47 

45.0,  46.0,  47.0 

RANGE 

10.0  TO  20  STEP  5 

10.0,  15.0,  20.0 

VIS 

5.0  0  TO  10  STEP  5 

0.0,  5.0,  10.0 

MODEL 

4  3  6 

4,  3,6 
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Table  C-4.  Allowable  Compiler  Commands  As  Typed  From  the  Main  Menu 


compile  [card,  image  name ]  [/MESH  /NOMESH  /ERROR] 

or 

3  [carriage  return ]  [card  image  name ]  [/MESH  /NOMESH  /ERROR] 


/MESH  Generates  All  Possible  Combinations  of  Perturbed  Input  Parameters 

/NOMESH  Perturbs  One  Parameter  at  a  Time,  Holding  All  Others  Fixed 

/ERROR  Creates  SEN. ERR  Containing  Compile  Errors  and  List  of  Active  Molecular  Absorbers 


Table  C-5.  Examples  of  Compiler  Commands  as  Typed  From  the  Main  Menu 


COMMAND 

EFFECT 

compile  test  /m  /e 

Compiles  input  file  named  TESTJNP  as  MESH  and  generates 
the  error  file  SEN. ERR 

3  < RETURN > 
test  In 

Compiles  input  file  named  TESTJNP  as  NOMESH  with  no 
error  file 

com  test. wow 

Compiles  input  file  named  TEST. WOW  using  last  mode 
(MESH  or  NOMESH)  as  default,  no  error  file  generated 

c  test.dumb  / m  / n  /e 

Compiles  input  file  named  TEST  DU  MB  as  NOMESH 
demonstrating  that  MESH  and  NOMESH  are  exclusive, 
with  NOMESH  taking  precedence. 

An  error  file  is  created 
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Table  C-6.  Type  of  Plots  Available  in  the  Graph  and  Analyze  Module 


PLOT  TYPE 

SPECIFIC  PLOTS 

PARAMETERS 

Raw  x,  y,  z 

Transmittance 

Total  Transmittance 

Log  of  Total  Transmittance 

Uniform  Mixed  Gases 

Trace  Gases 

Molecular  Scattering 

h2o 

H20  Continuum 

Ozone  (O3) 

N2  Continuum 

Aerosol  and  Hydrometeor 

C02 

CO 

CH4 

n20 

02 

nh3 

NO 

no2 

so2 

hno3 

Aerosol  and  Hydrometeor  Absorption 

IEMSCT  =  0 
IMULT  =  0 

Atmospheric 

Radiance 

Total  Transmittance 

Radiance 

Log  of  Total  Transmittance 

IEMSCT  =  1 
IMULT  =  0,1 

Differential 

Transmittance 

DTAU 

DTAU  /  Layer  Thickness 

IEMSCT  =  1,2 
IMULT  =  0 
NOPRT  =  -1 

Black  Body 
Function 

DTAU  *  Black  Body  Function 
(DTAU  *  Black  Body  Function)  / 

Layer  Thickness 

IEMSCT  =  1,2 
IMULT  =  0 
NOPRT  =  -1 

Fluxes/Irradiance 

Upward  Total  FLUX 

Upward  Solar  FLUX 

Downward  Total  FLUX 

Downward  Solar  FLUX 

Direct  Solar  Irradiance 

IEMSCT  =  1,2 
IMULT  =  1 
NOPRT  =  -1 

Solar/Lunar 

Radiance 

Total  Transmittance 

Radiance 

Path  Scattered 

Single  Scattered 

Total  Ground  Reflectance 

Direct  Reflected 

Total  Radiance 

Log  of  Total  Transmittance 

IEMSCT  =  2 
IMULT  =  0,1 

Direct  Solar 
Radiance 

Total  Transmittance 

Transmitted  Solar 

Incident  Solar 

Log  of  Total  Transmittance 

IEMSCT  =  3 
IMULT  =  0 
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Table  C-7.  List  of  Numerical  Commands  in  Graph  and  Analyze  Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

A2T 

NONE 

Optical  Depth  to  Transmittance  Transformation 
Transform  z  axis  according  to  z=exp(-z) 

DX 

NONE 

Compute  partial  derivative  of  the  data  set 
with  respect  to  the  x  axis 

DY 

NONE 

Compute  partial  derivative  of  the  data  set 
with  respect  to  the  y  axis 

DDX 

NONE 

Compute  second  partial  derivative  of  the  data  set 
with  respect  to  the  x  axis 

DDY 

NONE 

Compute  second  partial  derivative  of  the  data  set 
with  respect  to  the  y  axis 

DYDX 

NONE 

Compute  cross  derivative  of  the  data  set 
with  respect  to  the  y  axis  and  then  the  x  axis 

DXDY 

NONE 

Compute  cross  derivative  of  the  data  set 
with  respect  to  the  x  axis  and  then  the  y  axis 

LOG 

[X][Y][Z] 

Transform  all  coordinates  of  the  named  axis 
to  their  log  values  (Example:  ‘log  x’) 

MAXIMUM 

NONE 

Write  the  maximal  z  values  on  the  screen  along 
with  their  x,y  coordinates 

MEAN 

NONE 

Compute  and  displays  the  mean  z  axis  value 

MINIMUM 

NONE 

Write  the  minimal  z  values  on  the  screen  along 
with  their  x,y  coordinates 

NOSORT 

[X][Y] 

Suppress  SENTRAN’s  tendency  to  sort  data  into 
increasing  order  (Example:  ‘nosort  x’) 

SWAP 

NONE 

Swap  the  x  and  y  axes 

T2A 

NONE 

Transmittance  to  Optical  Depth  Transformation 
Transform  z  axis  according  to  z=log(l/z) 
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Table  C-8.  List  of  Plotting  Commands  in  Graph  and  Analyze  Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

PLOT 

[file  name][VT240] 

Plot  the  data  set  to  the  specified  file  name 
(*.TEK)  or  to  the  screen  [VT240  argument] 
(NOTE:  Both  arguments  may  be  specified  and 
the  program  will  plot  the  data  to  the  file 
and  to  the  screen) 

TITLE 

[plot  title] 

Treat  all  following  text  as  title  for  next  plot, 
and  center  this  text  at  the  top  of  the  plot 

XLABEL 

[ x  axis  Label] 

Treat  all  following  text  as  the  x  axis  label 
(up  to  30  characters) 

YLABEL 

[y  axis  Label) 

Treat  all  following  text  as  the  y  axis  label 
(up  to  30  characters) 

ZLABEL 

[z  axis  Label] 

Treat  all  following  text  as  the  z  axis  label 
(up  to  30  characters) 

Table  C-9.  List  of  I/O  and  Control  Commands  in  Graph  and  Analyze  Module 


COMMAND 

ARGUMENTS 

DESCRIPTION 

WRITE 

[x,y,  s  file  name] 

Write  the  current  data  set  to  the  named 
file  as  raw  x,y,z  data 
(default  extension  is  .3D) 

COSMETIC 

[file  name] 

Screendump  of  current  G&A  command  screen 
to  the  named  file 

NEW 

NONE 

Restart  the  G&A  Module 

EXIT 

NONE 

Exit  the  G&A  Module,  return  to  Main  Menu 

HELP 

[command  name] 

Accesses  the  G&A  on-line  help  utility. 

If  a  valid  G&A  command  is  supplied  as  an 
argument,  then  help  on  the  selected  command 
is  provided.  If  no  argument  is  supplied, 
then  a  special  introductory  HELP  screen  is 
presented,  listing  all  of  the  G&A  commands. 

REFRESH 

NONE 

Redraw  the  G&A  command  screen 
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Table  C-10.  Default  File  Names  Associated  With  SENTRAN7 


FILE  NAME 

AND  EXTENSION 

ORIGIN 

CONTENTS 

*MTH 

SENTRAN7 

Methodology  files 

*JNP 

SENTRAN7 

LOWTRAN7/MODTRAN  input  files 

*.PRO 

User 

Model  atmosphere  data 
(i.e..  Card  2C  series) 

*AER 

User 

Aerosol  extinction  coefficients 
(i.e..  Card  2D  series) 

*.PHS 

User 

Aerosol  phase  functions 
(i.e..  Card  3B  series) 

*.OUT 

LOWTRAN7/MODTRAN 

Output  data  used  for  plotting 

*.3D 

User/SENTRAN7 

Raw  x.y,:  data 

*.TEK 

SENTRAN7 

Tektronix  graphics  files 

*.COS 

SENTRAN7 

Cosmetic  data 

SEN.ERR 

SENTRAN7 

Error  log  and  major  absorber 
infomation 

SENLOG 

SENTRAN7 

User  input  log 

*  is  a  wildcard  indicating  arbitrary  text 
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Table  C-l  1.  File  Checklist  for  SENTRAN7 


FILE  NAME 

CONTENTS 

senmain.for 

Source  code  for  SENTRAN7  (main  program  only) 

sensubs.for 

Source  code  for  SENTRAN7  (other  routines) 

sennewfor 

Source  code  for  SENTRAN7  (routines  created  by  SPARTA) 

senvms.for 

Source  code  for  SENTRAN7  (VAX  computer  systems  only) 

senunix.f 

Source  code  for  SENTRAN7  (UNIX  computer  systems  only) 

MAJABSDAT 

Data  file  defining  regions  of  molecular  absorption 

DIRECT.ORY 

Configuration  file  containing  directory  and  name  of 
LOWTRAN7  and  MODTRAN  executables  and  the 
UFTAPE.DAT  file.  Current  directory  is  assumed  when 
DIRECT.ORY  does  not  exist 

SENTRAN.HLP 

SENTRAN7  on-line  help  utility  file 

M0DEL1  .PRO 

Tropical  atmosphere  profile  (i.e..  Card  2C  series) 

M0DEL2.PR0 

Midlatitude  summer  profile 

M0DEL3  .PRO 

Midlatitude  winter  profile 

MODELA.PRO 

Subarctic  summer  profile 

MODEL5.PRO 

Subarctic  winter  profile 

MODEL6.PRO 

U.S.  standard  profile 

SAMPLE.AER 

Sample  Card  2D  series:  normalized  aerosol  extinction 
versus  wavelength  for  four  aerosol  regions 

SAMPLE.PHS 

Sample  Card  3B  series:  aerosol  phase  functions  for 
four  aerosol  regions 

DEFAULTMTH 

Sample  methodology  file  (used  in  Tutorial  #1) 

lowtran7 .for 

Source  code  for  LOWTRAN7 

modtran.for 

Source  code  for  MODTRAN 

mkbin.for 

Program  creates  UFTAPEDAT  from  BMTAPEDAT 

makefile.com 

Command  file  for  compiling  and  linking  SENTRAN7 
on  VAX/VMS  systems.  Type  ‘(^makefile’  to  execute 

makefile 

Unix  command  file  for  compiling  and  linking  SENTRAN7 
on  SUN  systems.  Type  make  to  execute 
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Appendix  D 

Flow  Chart  for  the  Graph  and  Analyze  Module 

As  discussed  in  the  report,  the  SENTRAN  7  Graph  and  Analyze  Module  has 
a  structure  that  imposes  graphing  restrictions  on  the  user.  Figure  D-l  outlines  the 
logical  flow  for  selecting  the  plotting  parameters  in  the  Graph  and  Analyze  Module 
of  SENTRAN7. 

As  noted  in  the  flow  chart,  there  are  three  basic  choices  for  plotting  and  each 
choice  has  specific  options  specified.  If  selected  to  plot  a  raw  x,  y,  2  data  file, 
the  Graph  and  Analyze  Module  will  immediately  prompt  the  user  for  the  name  of 
the  file.  This  file  is  then  read  in  and  the  command  screen  is  presented  to  the  user 
for  entering  commands  to  manipulate  and  plot  the  data  set.  If  the  user  is  plotting 
differential  transmittance,  black  body  functions  or  fluxes/irradiance,  the  x  and  y 
axes  are  automatically  set  to  layer  #  and  wavenumber,  respectively.  The  user  then 
selects  the  2  axis  parameter  to  plot  and  enters  a  LOWTRAN7  tape8  type  file  to 
be  read  in.  Finally  for  all  other  plot  types,  the  user  selects  the  parameters  to  be 
plotted  on  the  x,  y  and  2  axes,  according  to  the  flow  diagram  in  Figure  D-l.  The 
user  is  referred  to  Section  4.2.7  for  more  inform^-m  on  the  Graph  and  Analyze 
Module  of  SENTRAN7. 


112 


Eater  Command  Loop 


Figure  D-l.  Simplified  Row  Diagram  for  Selecting  Plotting  Parameters  in  the 
Graph  and  Analyze  Module.  PAR  AMI  and  PARAM2  represent  the  first  and  second 
LOWTRAN7  variables  perturbed 
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